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PERFECTION SPECIAL EDITION 


mj POWER 

PERFECTION SPECIAL EDITION has 253 (two hundred and fifty three) direct/menu commands 
(not counting options in sub-menus), plus 32 special characters (like Bold on) that can be 
inserted ‘directly’ plus intelligent (and now excellently documented) macros. Comparisons with 
other word processors on the subject of power are hence quite unnecessary. 


Mi EASE OF USE 

Independent reports, customer feedback and published reviews (of its less 
able but still excellent predecessor, PERFECTION) leave one in no doubt as 
to which word processor is friendliest - PERFECTION SPECIAL EDITION, 
with its intuitive, silky handling. Uniquely, it has two operating modes, with 
both menus (visible or invisible — they even look like Quill's) and direct 
commands (for when you familiarise yourself with the system). Uniquely, 
both modes are ‘re-entrant’ (so you can use any menu option or direct 
command while you are in the middle of performing another option or 
command — block handling, etc, becomes a dream). Uniquely, PERFECTION 
SE has fully automatic memory management, grabbing and releasing RAM 
instantly as your document grows or shrinks — programs without this don't 
take full-advantage of the multi-tasking abilities of the QL! Uniquely, 
PERFECTION SE leaves you in the driving seat, not juggling things around 
‘underfoot’ while you are typing. Uniquely, PERFECTION SE allows up to 
nine different documents to be handled simultaneously from one copy of the 
program — each with totally independent margin, tab, justification, control 
panel, etc, settings. Uniquely, each document can itself have up to six environment settings, 
each settable or recallable instantly with a single keypress combination. Each document can 
have any number (up to 500,000 on GOLD CARD) of candidate blocks! Each ‘dogument can 
have two independent windows (of any depth, of any (but same) width across) ‘on to’ it, even 
with overlapping text — that allows you to edit in one place while viewing another, to compare 
‘before editing’ with ‘after editing’ (you can arrange to have one window remain ‘frozen’ in time), 
etc. Uniquely, we realise how much faster it is to type in something like CTRL/SHIFT/F5 than 
(say) F3 F3 R — both involve three keys, but as the former doesn't require the keys to be 
pressed in just one specific order, or to be released in any order at all (together will do), it is in 
practice twice as fast as the latter, where no key may be pressed until its predecessor is 
released. PERFECTION SE takes advantage of all this — it is the little things that count! 
Uniquely, by providing eight user-definable strips, PERFECTION SE allows you to cope with 
printers of the future, not just the printers that now exist — you can attach the strips to any 
printer features. Uniquely, PERFECTION SE's status lines give full information on all relevant 
global settings. And the manual has an index. Also, it has all the important bits at the front. 


mi WYSIWYG? 

By the latest definition of this term, neither is PERFECTION SE fully WYSIWYG, nor are other 
QL word processors. WYSIWYG means what you see on screen is exactly what you get on 
paper. Exactly — down to every wiggle in every character in every font. 


To get true WYSIWYG, use PERFECTION SE's fully automatic link (supplied as part of 
PERFECTION SE) to PROFESSIONAL PUBLISHER, where you will get 100% WYSIWYG. 
100%? Yes, 100%. With this combination, adjust the horizontal and vertical magnification on 
your monitor (ie calibrate it once and for all so screen circles correspond to same-diameter 
printed circles — poor monitors may distort a little bit at the edges). Now you can place your 
printed output from PERFECTION via PUBLISHER over your monitor screen, and get a match 
that is more perfect than is your eyesight. Now that is WYSIWYG. 


mi SUPERB PRINT QUALITY & FLEXIBILITY 

Uniquely, using the aforementioned automatic link, you can output PERFECTION SE 
documents using over a thousand fonts (a huge variety of styles and sizes, supplied on the 
PUBLISHER and TOOLBOX disks) on virtually any printer — from the humblest Epson RX80, 
Brother M1009 or Star LC10 (which are all single font machines when used with most word 
processors) to top-end lasers. Yow are wot limited to the faute Cutt tuto the 
prteter(/ A\| PERFECTION SE bold/underlined/ italics/SUPEl/g) jp, etc, settings are 
preserved. Proportional spacing and micro-justification are automatic, even when you 
mix fonts of differing widths «nd Leight, (even on the same line), vary line spacings, 
etc. Uniquely, you are not trapped with one type of micro-justification (ie adding all the space 
between words, and using the predefined widths of characters as their separation) — with our 
system, you can vary (in 5% steps) the proportion of micro-spaces added between words to 
that added between characters (the latter in proportion to their individual widths). Settings 
around 65%-35% — not the 100%-0% forced upon you by some other word processors — 
seem to give the most pleasing results. Uniquely, you are not limited to mere rectangular 
columns plus headers/footers — that's all the rest can do — you can output in any sequence to 
any number of frames (text flowing from one to the next), each of any shape — irregular 
polygons of up to 66 sides, circles, multi-column or part-column boxes (hundreds of types of 
borders, thousands of textures), doughnuts, wrap-around shapes, even re-entrant ones 


the best! 


Professional Publisher is 
Ho other desktop 


publisher for the QL even comes close. 
teat » 


(‘join-the-dots’ type borders, even with intersecting edges) — all with micro-justification and 
proportional spacing! Look at the example on this page. Of course, if super fancy output or 
special effects are not of the essence, PERFECTION SE's direct printer output is more than 
capable of meeting your needs. 


mi THE FASTEST 

For benchmarking, we've used an unimpeachable file — not one created 
specially — a public domain version of the first book of The King James 
Bible, all fifty chapters of the book of Genesis. This came to one hundred 
and forty pages, well over forty two thousand words excluding 
headers and footers, well over two hundred and twelve thousand 
characters excluding justification ones and one thousand five 
hundred and thirty three indexed verses!! We didn't use a smaller file 
(as used to benchmark other programs) as PERFECTION SE's timings for 
most operations then become impossible to stopwatch (too fast!). The 
hardware used for all timings was GOLD CARD: speeds would be further 
improved by over three times using the suPER Gc. Of course, 
LIGHTNING SE was used. File operations were to ramdisk: normal slave 
blocks would give identical times. All settings on everything were for 
maximum speed, except where indicated to the contrary — we have the sense 
not to force full speed upon you in operations like scrolling and glabal 
Search & Replace. PERFECTION SE’s speed for these is switchable 
(at run-time and when configuring), as too great a speed may cause 
overshoot (with scrolling) or fatal alteration (if there is human error inputting the target or 
replace strings). Here are the benchmarks for this huge file: 


Load 140 pages: 0.6 seconds (yes 0.6, not 6!) vx Import 140 pages: 0.6 seconds (yes 0.6, not 
6!) vx Save 140 pages: 0.5 seconds (yes 0.5, not 5!) vx Export 140 pages: 0.5 seconds (yes 
0.5, not 5!) vx Case-sensitive search from top for word at bottom: 0.4 seconds (yes 0.4, not 4!) 
vx The same, but case case-insensitive: 0.5 seconds (yes 0.5, not 5!) vx Case-sensitive search 
backwards from bottom for word at top: 0.4 seconds (yes 0.4, not 4!) zw The same, but case- 
insensitive: 0.5 seconds (yes 0.5, not 5!) vx Automatic Search & Replace, in Fast (No Query) 
mode, of last 600 occurrences: 7.4 seconds (same length replace string); 7.7 seconds (shorter 
replace string); 10.5 seconds (longer replace string — longer time as we deliberately chose a 
high density of replaces to handicap PERFECTION SE into auto-managing memory — without 
causing any heap fragmentation, but still with only a 0.005 second overhead per replace!) . 
vx Automatic Search & Replace in Slow (‘Querying’) mode: arbitrarily slow, typically 30 times 
slower — because we deliberately allow for human response time (in case you want to abort) 
before proceeding from one replace to the next — booby prize to anyone for benchmarking us on 
this setting!! 2% Scrolling 100 lines of text, up or down, by full-width screen page: 1.5 seconds 
vx Scrolling 100 lines of text on full-width screen, line by line, in slow (full) mode: 5.7 seconds 
(down)/5.8 seconds (up) vx As above, but in medium speed mode: 4 seconds vx The same, but 
in fast mode and default settings: 13.5 seconds to scroll through the whole massive document, 
averaging 0.23 seconds per 100 pages (!) — and this could be made up to ten times faster by 
reconfiguring PERFECTION SE v& Reformatting paragraphs, changing margins, justification, 
etc, of existing text: c5 times faster than predecessor xx Inserting (or undoing) emphasised, 
underlined, italics, superscript, subscript, 8 strips, 6 environment settings: Instant 
(i.e. immeasurable) x Navigation to line or page or to top or bottom or to 8 markers or to 
highlights/blocks: Instant x Setting new margins, justification, etc: Instant vx Deleting block of 
100 pages: 0.3 (yes, 0.3 not 3!) seconds vx Copying/moving block of 100 pages (not just 10!), 
downwards or upwards: 3.4 seconds (yes, including all the time for automatic memory 
management and anti-fragmentation — other programs are light-years behind) vx Spellcheck as 
you type: Ten times faster than anyone can possibly type vx Spellcheck all 140 pages in the 
document using the 350,000 word Mega Dictionary: 3.9 seconds (20 ‘errors’ — like ‘pluckt'!) 
vx And using our tiny dictionary (well, tiny by our standards — large by comparison with most 
others): 5.1 seconds (566 ‘errors') vx Time taken to create user dictionary from the results of the 
second spellcheck (566 errors): 0.8 seconds to extract all ‘errors’ from document and clean 
document; 1.9 seconds to create a full user dictionary therefrom and also a sorted, duplicate- 
free wordlist file (for browsing) Hx Spellcheck file (ASCII or native): Even faster. & Print first 10 
pages to file: 3.5 seconds. Change every occurrence of God to Ged in bold underlined 
italics, strip 2-9.5 seconds! 


TECHNICAL NOTES. Reformatting is the amendment of a section of previously-entered text to conform to margin, 
indentation, justification and pagination settings after the user returns to it and makes alterations, either by hand (by 
over-typing, deleting, adding or otherwise changing) or using search and replace, merge etc. PERFECTION SE lets the 
user pre-configure, or tune at run-time, the desired reformatting behaviour. The options are to either select Never (most 
suitable for technical users, and what all previous PERFECTIONs did: you had to initiate the reformat of the re-edited 
para), Instant (= 0.1 seconds, giving in-situ real-time automatic reformatting as-you-type: common in word processors, 
and irritating to the eye) or User-delay, the most flexible setting (giving slightly delayed auto-updating ef lower text). On 
User-delay the user is free to set any delay from 0.2 seconds to 99.9 seconds in 0.1 second steps. About 1.5 seconds is 
best for sedate typists and 0.3 seconds for speed demons. This means that you are not hassled by continuing screen 
changes.on lines below the one you are editing and concentrating upon, or shufflings around on the current line caused 
by right or centre justification. When you pause in your typing for longer than the set delay, PERFECTION SE 
automatically tidies up, without you having to do anything. On User-delay, if you navigate or progress off the line, or 
invoke any menu or command (including Save, Print etc.), an auto-reformat occurs instantly. This means that you are 
Dever left with the document in the wrong state. With these options, you have the best of al! possible worlds. 


Also, SHIFT/CAPS now obeys the indent margin (which matters if the cursor is on the first line of a para) and leaves the 
cursor position unaltered within the text. Other reformatting commands are unaltered, so you can still step through paras 
reformatting manually as you go, if you wish. The maximum number of lines, characters, words, lines, pages etc have 
all been increased (effectively to infinity: e.g., the new limit on characters is 30 million-million, this up from 2 million, 
restrictive in Super Gold Card / QXL days!). Also, the new version (starting with v5.13) is even faster, and its handling of 
complex search/replaces (say, involving end of line codes) has been optimised. PERFECTION SE really is superb! 


DIGITAL PRECISION PRICES 

3-D PRECISION CAD SYSTEM 

ADVENTURE CREATION TOOL SPECIAL EDITION 

ARCADIA GAME 

ARCHIVE DEVELOPMENT SYS + RUN-TIME MODULE 

ARCHIVE TUTORIAL 

BETTER BASIC EXPERT SYSTEM 

BLOCKLANDS GAME 

CASH TRADER v3.3 + ANALYSER 

COMPARE FILE UTILITY 

COPY UTILITY FOR BACKING UP 

CPORT BASIC TO C AUTO-TRANSLATOR WITH C68 COMPILER 

CPORT BASIC TO C AUTO-TRANSLATOR 

DATABASE ANALYSER FOR ARCHIVE 

DAT-APPOINT APPOINTMENT DATABASE SYSTEM 

DESKJET/LASERJET DRIVER FOR PRO PUBLISHER 

DESKTOP PUBLISHER SPECIAL EDITION 

DESKTOP PUBLISHER 

DIGITAL C COMPILER 

DIGITAL C SPECIAL EDITION 

DISKTOOL WITH QUICKDISK 

DROIDZONE GAME 

DR-DOS v7 STATE OF THE ART PC OPERATING SYSTEM 

EDITOR SPECIAL EDITION 

EDITOR 

EYE-Q GRAPHICS SYSTEM 

FONT ENLARGER 

GAMES COMPENDIUM (ALL FIVE GAMES) 

GRAFIX 24-PIN UNIVERSAL PRINTER DRIVER 

HARDBACK + FINDER HARD DISK MANAGER 

IDIS INTELLIGENT DISASSEMBLER 

IDIS SPECIAL EDITION 

LIGHTNING ACCELERATOR 

LIGHTNING SPECIAL EDITION ACCELERATOR 

LIGHTNING GOLD SPECIAL EDITION 

MAILMERGE DATABASE SYSTEM 

MEDIA MANAGER SPECIAL EDITION 

MEDIA MANAGER 

MEGA DICTIONARY 

MICROBRIDGE 

NAMES AND ADDRESSES DATABASE SYSTEM 

PAYROLL SYSTEM 

PC CONQUEROR GOLD SPECIAL EDITION WITH DR-DOS v7 

PC CONQUEROR GOLD SPECIAL EDITION 

PC CONQUEROR WITH DR-DOS v7 

PC CONQUEROR 

PEDIT PRINTER DRIVER FOR XCHANGE 

PERFECTION PLUS SPECIAL EDITION WITH SPELLCHECKER 

PERFECTION PLUS WITH SPELLCHECKER 

PERFECTION SPECIAL EDITION WORD PROCESSOR v5 

PERFECTION SPECIAL EDITION DEMO VERSION + SAMPLE DATA 

PERFECTION WORD PROCESSOR v3 

PERFECT POINTER TOOLS 

PROFESSIONAL ASTROLOGER WITH ASTRONOMER 

PROFESSIONAL ASTROLOGER 

PROFESSIONAL ASTRONOMER 

PROFESSIONAL PUBLISHER TOOLBOXES (BOTH PARTS) 

PROFESSIONAL PUBLISHER TOOLBOX PART ONE 

PROFESSIONAL PUBLISHER TOOLBOX PART TWO 

PROFESSIONAL PUBLISHER 

QFLICK CARD INDEX SYSTEM 

QKICK FRONT END SYSTEM 

_ QMATHS MATHEMATICAL SYSTEM PART ONE 
QMATHS MATHEMATICAL SYSTEM PART TWO 

QMATHS MATHEMATICAL SYSTEM (BOTH PARTS) 

QMON MACHINE CODE MONITOR 


QUICKLASER PUBLISHER DRIVER FOR LASERJET/DESKJET PRINTERS 


RECOVER ARCHIVE UTILITY 

REVERS! GAME 

SEDIT + SCREENPRINT ARCHIVE UTILITIES 
SOLUTION PC EMULATOR WITH DR-DOS v7 
SOLUTION PC EMULATOR 

SPELLCHECKER WITH DICTIONARIES 
SUCCESS CP/M EMULATOR 

SUPERBASIC MONITOR 

SUPERFORTH COMPILER WITH REVERSI 
SUPER ASTROLOGER 

SUPER BACKGAMMON GAME 

SUPER SPRITE GENERATOR 

TOOLKIT Ill WITH ROM 

TOOLKIT III 

TRANSFER UTILITY SPECIAL EDITION 
XREF SUPERBASIC PROGRAM ANALYSER 
TRANSFER UTILITY 

TURBO BASIC COMPILER + TOOLKIT 
ULTRAPRINT SCREEN DUMP UTILITY 
XREF SUPERBASIC PROGRAM ANALYSER 
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KEY a=Available either on cartridge or disk; b=Disk only; c=Minimum 512K exp: disk 
only; d=Minimum 256K exp: either cartridge or disk; r=Minimum 256K exp: disk only; 
s=Cartridge only; g=Minimum 1.5Mb RAM: disk only disk; h=ROM + (cartridge or disk) 


AND NOW - BEST-EVER SPECIAL DEALS... 


5% off 2 progam 
0% off 3 progrars 


Lh off 4 progars 
Uh Off 9 Plogans 
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This amazing product is the way forward for the QL. Like Gold Card before it, the 
brand-new Super Gold Card is a plug-in disk interface and RAM expansion that 
works on all QL versions. Incredibly, it is over three times speedier than Gold Card, 
with over twice the RAM and with many enhancements. It complements LIGHTNING 
SPECIAL EDITION like nothing else, squeezes the best out of TURBO (which was 
designed with 32-bit CPUs in mind) and really accelerates PC CONQUEROR. Super 
Gold Card is actually as fast, or slightly faster, than the much vaunted QXL: also, it is 
100% QL-compatible now, and no PC is needed. The table below really says it all: 


System 3 Bare TRUMP | GOLD SUPER 
L Features QL CARD | CARD GOLD CARD 
Relative Speed 1x 1.8x 7x 25x ! 
Motorola CPU 68008 68008 68000 M68020 
Clock Frequency 7.5MHz 7.5MHz 16MHz 24MHz 
Bus width 8 bit 8 bit 16 bit 32 bit 
RAM fitted 128Kb 896Kb 1,920Kb 3,968Kb 
RAM access speed Slow OK Fast Twice as fast 
PCB population V.high High V.low V.low 
Physical dimensions Monolith Full-size  Half-size Half-size 
Lock-up frequency Ouch! Occasional  V.rare Won't 
Battery Backup Clock No No Yes Yes 
Clock Protection level N/A N/A Modest High 
Toolkit Il + Manual No Yes (earlyvns) Yes Enlarged 
Sub-directory support No No Yes Yes 
Parallel/Centronics port No No No Yes 
Spooler/Screendump/Ramdisks No Yes Yes Yes 
Speedup switch (Screen#2) No No No Yes 
Future hi-res graphics No No No Planned 
Disk drives supported N/A SD/DD  SD/DD/HD/ED SD/DD/HD/ED 
Max no: of disk drives 0O 2 3 4 
Max sectors/disk N/A 1,440 6,400 6,400 
Max disk transfer rate N/A  30Kb/sec 120Kb/sec >120Kb/sec 
Peripheral card tolerance OK No No OK 
SCSI-2 compatibility to-be No ? No Yes 
Miracle/DP Warranty No No 2 years 2 years 
DIY/Kit incorporability Yes No No Yes 
Overall Rating by DP 2% 10% 30% 110% 


And to the Very Best news: from DP, SUPER GOLD comes SUPER CHEAP! 


SUPER GOLD CARD, plus a no-limit extra 20% SOFTWARE 
DP DISCOUNT VOUCHER, plus a FREE mystery DP program, 
plus a FREE Dust Cover, will cost you a mere £375 VV¥Vv 
Less £125 if part-exchanging your standard 2Mb Gold Card 
Add £125 for ED 6400-sector Disk Drive (PSU, cased, cables). 


OTHER HARDWARE EXCHANGED AND SOLD BY ARRANGEMENT. PLEASE 
ORDER NOW: WE EXPECT VERY HIGH DEMAND FOR SUPER GOLD CARDS, 
AND WE DON'T WISH TO DISAPPOINT. INTERNATIONAL RAM PRICES ARE 
UNSTABLE AND PRICE HIKES MAY BE INEVITABLE. CONSEQUENTLY, THE 
ABOVE COMBINATION OFFER COULD BE WITHDRAWN WITHOUT NOTICE... 


The software discount must be taken at the same time as the main order, and CAN be 
combined with the SPECIAL DEALS discounts. For example, if you chose six DP programs of 
total list price £100, you would only have to pay £100 -40% -20% = £48 for them! And, of 
course, you would also get the two gifts absolutely free, and a 4Mb SUPER GOLD CARD too! 


TERMS & CONDITIONS * We accept payment by VISA, Mastercard, Access, Eurocard, Eurocneque, £ cheque drawn on 
a UK branch of any bank or building society, postal order, cash, travellers cheques or direct funds transfer to our bank 
account #60327808 at Barclays Bank plc, South Chingford Branch (sort code 20-53-00), NE London Business Centre, 
PO Box 2403, London N18 2BY. If you must use another currency, add 7.5%. If you must use another form of cheque, 
add £15. * Upgrades cost only the difference in current price plus £10; return the original disk and manual. But do 
NOT return the manual if the upgrade is to a "SPECIAL EDITION" of your original program: you will be sent useful 
supplementary documentation. Upgrades from LIGHTNING are the exceptions to the last rule! * Only DP programs and 
upgrades (i.e. not DR-DOS) count towards discounts. * Prices are all-inclusive for UK mail-order. Rest of Europe, add 5%. 

Elsewhere, add 10% (Air Mail). * We aim for 24 hour turnaround. * DP & Digital Precision are trading names of Digital 
Precision Ltd, Company No.1 833989, registered in England & Wales. * Orders using your own paper are also welcome! 


oc Bc OC O< O<OK O< O< OX OX OB OX EC OX PK OO OC OC OC OS OS OS OS OS OS 
Post to: D/G/TAL PRELCIS/ON, 222 The Avenue, London E4 9SE, UK 
or phone on 081-527 5493 from UK, +44 81-527 5493 rest of the world 


Name: Address: 


Products ordered: 


on mdv/3.5"disk/5.25"disk* (no: of sectors on disk-format = 360/720/1440/2880/6400*; if 5.25"/720, specify 40/80* track) *=delete ay needed. 


Signature: Amount: £ 
Card No: Expiry date: 
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Fairs Now’ 


Don't forget the Quanta/ SQLUG 
workshop at.Napier University, 
Colington Road, Edinburgh on 
February 12th - contact Alan 
Pemberton on 031 660 1826 (early 
evenings) for information. 

And the International QL Meeting 
at the University of Bielefeld, Germany 
(near Munster) on February 19th - 
contact Franz Herrmann, E-mail: 
Franz_Herr- mann @ bn.maus.de D- 
53545 Ockenfels for information. 

We have some last minute infomra- 
tion about exhibitors and accommo- 
dation today: Miracle, TF Services, 
Progs, Qubbesoft, EEC, Grange 
Technology, Jurgen Falkenburg, Albin 
Hessler, NASA (Norway), Ergon 
Development, Qltaly, Oliver Fink 
(QSpread) and Jochen Merz are 
among those expected. 

For more information reach Andreas 
Rudlof on ++ (010 from Uk) 49 2242 
85515, Franz Herrmann on ++49 228 
231480 or the Bielefeld Tourist 
Information office on ++49 521 
178844. Andreas has a faxable list of 
information and hotels for travellers. 


PAGE DESIGNER - THE NEXT GENERATION! 


DJC now has a completely re-written Desktop Publisher, Page Designer 3, 
THe Next Generation, ready for use. 

PD3, the new incarnation of old favouite Page Designer two, has been entirely 
rewritten (‘well, almost’) by author Bary Ansell for the QL in the 1990s, operating 
under todays’ extended QL environment to use pointer (mouse) contro! or key- 
board control. “QL Desktop Publishing Made Simple!” is the program’s motto. 
Even so, it is a serious tool, and needs minimum 512K and SuperToolkit Il to 
run. It is also Gold Card and Minerva compatible. 

The four-disk package includes, with DP’s permission, Digital Precision’s High 
Definition Font format, and new and more efficient built-in printer routines. 

The A4 instruction manual deals with the program menu by menu, and also 
has detailed information about page sizes, file checklists for all four disks, a sep- 
arate section on the Font Editor, and printed pages of clipart for guidance. 

PD3 costs £40 (Post free in UK, postage £1 per program (max. £3) overseas), 
or an update kit for £25. Various clipart packs are available for £10 or £12. All 
orders and requests for information to Dilwyn Jones Software, tel. 0248 
354023, 

QL World would like a review of PD8 from an experienced PD2 user or desk- 
top publishing user - we can supply software - and in due course we would like 


Complete Indexer from DJC 


New from DUC is Qindex, a program to assist in producing sorted indexes for 
a book or file. Unlike database-type indexing programs, where the entries are 
typed into a list, you can load into this program a plain text file or Quill _doc, 
and flag words and phrases directly to be inserted into an index. The resulting 
index can be built up from several text files (such as chapters of a book or 
manual), not just one. 

There is a Search facility to find all occurences of an item to be indexed. 
Entries 


with sIM- DOCUNENT sample_txt 
ilar refer- § Mark Entry Mark Ref Seanch EE 
ences 9.8 QUICK TUTORTAL rint Style 
ines per Page 
G2h\0 be eee 
automat- 
ically L Spaces 
com by pressing D or by moving the poi Chars/Spaces# 
- ilus or Do. “ cannery 

’ ilo.3 In the file select menu, choose the required drive if it 

b ine d 3 His mot the one shown. When you can see the filename 
‘ SAMPLE_txt, move the pointer over it and Do. 
There Is Fr) ter the program has returned to the menu, press N to 
a neu index file. If the program says ‘Already 
an on- ', choose the Overurite option. 
love the ‘hand’ pointer down into the big box where the 
screen ; t is displayed. The ‘hand’ changes to a flashing red 
ons {cursor . 
facility to j12.6 Move the cursor over a word or phrase to be added to the 
| index (e.g. the word TUTORIAL) and press E for a new entry. 

erovurTn t A green marker appears . 
toh we 
number of entries. 


Once finished, the index can be exported to a text editor (if desired) for 
restyling etc. prior to printing. The program has a choice of text pitches from 10 
cpi to 20 cpi, allowing layouts of different numbers of columns. Other layout 
choices include: entries beginning with different characters can be separated 
with a blank line, or a line containing the single character as a header, for 
instance. Users can devise their own layouts, or move the index to another edi- 
tor for layout. : 

Indexer is Gold Card and Minerva compatible, and works in the Pointer 
Environment (Supplied), so that a mouse can be used if desired. It can also be 
driven entirely from the keyboard. 

The program is on disk only (3.5 in or 5.25 in) and needs an expanded mem- 
ory and Toolkit II (normally built into the disk interface). A complete printed man- 
ual is included. 

QL World would like a review from an experienced indexer in due course. 
Indexer costs £20. Cheques etc. should be made payable to Dilwyn Jones 
Computing. Tel. 0248 354023. For address etc. see Dilwyn’s ad. on the back 
cover of this issue of QL World. 
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QL STOCKS SOLDIERING ON 


Bill Richardson only has about 20 of his famous New QLs left! The unused 
QLs, complete with original packing and manual, are the last of the shipment 
bought by Bill from their warehouse several years ago, where they had appar- 
ently been laying neglected since the “boom days’ of QLdom. 

Once this elite band have homes, it looks as though the last of the “first 
owner’ QLs will be gone for ever. The New QLs are still £120 for a JS package 
and £100 for the JM, and the price of a New QL includes a free one-year 
membership to Quanta. 

Bill accepts used QLs in any condition in part exchange, giving a £80 dis- 
count on the New QL prices. “We collect these for spares’, Bill explained. 
Richardson's “Backup QLs” - just the QL and its PSU, with no paperwork or 
software, are on sale for £80 for JS and £65 the JM rom versions. The part 
exchange allowance on the purchase of Backup QLs is £15, 

As for replacement keyboard membranes, “QL membranes are OK, but 
not the Spectrums.” It's too expensive now to order a whole batch of Spectrum 
membranes with sales very low. However, QL membranes and instructions for 
fitting them cost £9 from Richardson's. Other spares getting scarcer but still 
around are 8301 and 8302 chips for the QL, and ULAs for the microdrive units. 

Another threatened species is the microdrive cartridge. Manufacture of 
cassettes ground gradually to a halt some four years ago as documented in 
QL World, but steady sleuthing of unused stocks and second-hand cartridges 
by people like Bill has kept supplies coming. Bill reckons he has 3-400 left, 
and a sales tumover of about 200 a month, so if you want more microdrives, 
speak to him soon. Sample prices are 8 walletted second user cartridges, 


£15; filing box with 20 new cartridges, £465. 


Hardware designed by people currently in the QL market is selling steadily - 
Jugen Falkenburg’s I/O card at £235, and keyboard interfaces for PC-style 


keyboards, a popular QL mod, at around £75, depending on the kit. 


Phone Bill on 0753 888866 or send a medium SAE to W N Richardson 
(EEC), 18-21 Misbourne House, Chiltern Hill, Chalfont St. Peter, SL9 QUE. 


Enigma Solution 


Here is the solution to the coded message from the Engima pro- 
gram printed in QL World IL9 (Geptember 1993). 

Decoding the first six letters using the Code Indicator Setting CAT will 
reveal the Main Code Key GNU from which, after re-setting, the mes- 
sage can be decoded as: 

‘If you are looking for a magazine which will stretch your horizons and 
expand your knowledge of this versatile little machine, the Sinclair QL 
World is for you. Sign up for a years subscription now and take advan- 
tage of the latest offer. You'll never regret it” 

(George wrote that all by himself! He’s obviously due for a very suc- 
cessful second career as a diplomat!) 

Of course, there will not be any spaces, punctuation or capital letters. 
This is a mesage of 211 characters, which together with the sic charac- 
ters of the Main Code Key constitutes the total message length of 217 
characters, Remember that you can easily recover from an incorrect let- 
ter in the code, but never from a character omitted! If anyone wants 
more information, just write to us. 


Machine Code Listings Errata 


The followers of Alan Bridewell’s Machine Code For Beginners were 
on the phone to use as soon as their QL World II.12 hit the mat. Anyone 
who wants a replacement copy of the pale listings on pages 27 and 28 
(and also on page 21 in DIY Toolkit), or any of the other listings in those 
articles, write to me with your address and which listings you want, and 
we will send you a fresh copy. Allow a little time, as we have to get the 
originals back from the printers (or from Alan) 

Some Machine Code beginners may want a reprint of Listing 1 from 
part 6, issue I19, in which some lines were omitted due to an obscure 


All Formats Diary 


In 1994, the All Formats Computer Fairs will be 
held monthly at three northern venues, and 
only occasionally in other places. 

The monthly fairs will take place at the National 
Motocycle Museum, junction 6 of the M42, oppo- 
site the National Exhibition Centre entrance (a 
very central location for many parts of the coun- 
try), Haydock Park Racecourse, J23 of the M6, 
between Manchester and Liverpool, and the 
Washington Leisure Centres at the top of the 
A1(). 

A smaller number of fairs will be held in Bristol, 
Glasgow, the South East, Belfast and Cardiff. It 
seems that the All Formats Fairs have dropped 
out of London altogether. 

In the next two months the following Fairs are 
lined up: Jan 23 West Midlands Motorcycle 
Museum; Jan 29 Essex Brentwood Centre; Jan 
30 Surbiton Southborough School; Feb 12 
Haydock Park; Feb 13 National Motorcycle 
Museum; Feb 26 Northumbria Centre, 
Washington; Feb 27 Glasgow Woodside Hall. 

The events are open from 10am to 4pm, 
entrance adult £4 (£3 with voucher), £2 child; £2 
all comers after 20m. A supply of “£1 off vouch- 
ers can be obtained by sending an SAE to All 
Formats Fairs, Maple LEft, Stretton-on-Fosse, 
Moreton-in-Marsh, Gloucestershire GL56 9QX. 
Stands at the fairs cost £60 tel. O608 662212. 
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OPEN 
CHANNEL 


Open Channel is where 
you have the opportunity 
to voice your opinions in 
Sinclair QL World. Whether 
you want to ask for help 
with a technical problem, 
provide somebody with an 
answer, or just sound off 
about something which 
bothers you, write to: Open 
Channel, QL World, The 
Blue Bam, Tew Lane, 
Wootton, Woodstock OX7 
1HA. 


Two Threes 


Following the review of 
Digital Precision’s QMaths 2 
mathematics collection, | 
would like to point.out that 
there are, in fact, two pro- 
grams called “3D Terrain” 
knocking about on the mar- 
ket at the moment! 

The other program was 
previously distributed by 
CGH Services (RIP) and is 


now handled by Dilwyn 
Jones Computing. My rea- 
sons for pointing this out are 
(a) pride and (b) blatant plug- 
ging of the product, since | 
co-wrote this version! 

The program included in 
the DP package is of 
American origin, and regular 
readers may recall that 
Bryan Davies reviewed both 
programs about a year ago, 
a couple of months apart. | 
am not rubbishing one in 
favour of the other! The two 
are very different and only 
share their name by chance. 
In fact, | would urge interest- 
ed readers to invest in both, 
since they fulfil different roles 
and are both low in price. 

If | may be allowed to 
briefly highlight some of the 
differences: the US program 
is a complex shape genera- 
tor with a very good graphi- 
cal capabilities (viewpoint, 
scale, colour, etc), whereas 
the GB program is a spread- 
sheet viewer, taking any 
exported Abacus spread- 
sheet data and supplying 
the results as a 3D surface, 
therefore allowing the user 
to input data. 

The US program produces 
a screen image by calculat- 
ing every pixel position, 
rather like a fractal viewer. 
The GB program is only 
concerned with calculating 
the end points of straight 
lines, which it combines with 
other similar lines to form a 
surface grid created from 
“diamond’-shaped elements. 
(Note: this is a bit like the dif- 
ference between colouring 
and texturing techniques in 
virtual reality, which trade off 
absolute detail against 
speed, depending on the 
application) 

In anyone is interested in 
this history of the GB pro- 
gram, | originally wrote my 
version because | got dizzy 
looking at OS maps of the 
very hilly areas near home 
where | went mountain-bik- 
ing. Therefore, the name ‘3- 
D Terrain’ seemed appropri- 
ate. In 1989, after successful- 
ly modifying Mike Lloyd's 
maths engine from his 3D 
graph series of the previous 
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year, | asked Richard 
Alexander of CGH Services if 
he thought much of the 
idea, which he did. The nec- 
essary copyright information 
was sorted out with Mike, 
but progress from the origi- 
nal to something pre- 
sentable was slow (my fault!). 
Rich Mellor was given the 
task of compiling the pro- 
gram using Turbo, but in the 
end he modified the original 
code and improved the 
‘feel’ of the program in 
many areas. 

From the outset, it was a 
hobby type of program, 
which is why it retains some 
of its amateur charm! Once 
the Basic loader program is 
set up to cope with the size 
of the latest version of DP's 
Lightning, and the Psion 
GPRINT_oprt file is copied 
across to the host medium, 
all is fine. The lack of demo 
files (there are only five) is 
again my fault, since it was 
intended to fit on an unex- 
panded, diskless machine. 
The Basic development ver- 
sions ran on a 128K QL, but 
the compiled version needs 
extra memory, although | 
think it may still squeeze 
onto a microdrive. 

The user can very easily 
enter data via Abacus, or 
anything that will Export data 
to Easel in the same way as 
Abacus. Endless demo files 
are relatively pointless, since 
3D-Terrain (GB) is a spread- 
sheet rather than a complex 
equation displayer, and the 
idea is that the users “get 
grubby” and stick their own 
numbers into the program. 
Of course, the data doesn't 
have to describe a land- 
scape, it could be rainfall, 
pressure, temperature, basi- 
cally any variable expressed 
over an area. The biggest 
demo file displays an actual 
landscape, but, as men- 
tioned in the manual, the 
program can handle four 
times as many data points 
than this image contains, 
limited by screen resolution, 
which ultimately affects all 
display programs. Gimmee 
a QXL with SVGA capabili- 
ties, please! 


Sorry this letter has grown 
into a book! | hope it clear 
up any confusion, and peo- 
ple don't ring Dilwyn thinking 
its the same program as is 
in the DP collection. 

lan Thompson 
Ripon 


Wrong 
Definition! 


Soon after | wrote my last 
letter to you | discovered an 
article [not in QL World or 
Quantal on Quill in 
Xchange which explained 
how the glossary worked. In 
the _doc files on the disk it 
only says: ‘These settings 
are automatically saved 
when you quit Quill”. Wrong. 
They aren't. The article adds: 
“By the QUIT command 
pressing ‘A’ (New - 
A=Abandon, and will only 
appear within the command 
box when defining a glos- 
sary file.” This is also wrong. 
If you type anything into 
Quill and try to quit before 
you save it, this option 
always Crops up. 

| experimented with this 
command and found it did 
save a glossary, but only 
once and then that was it. | 
have not been able to save 
a glossary since, and | can- 
not edit the original which | 
did in a hurry, and only as a 
trial. What is happening 
here? 

| must confess that | have 
problems with computer 
manuals and often have to 
read them several times 
before understanding what | 
am really supposed to do, 
so | often make mistakes. | 
spent ages trying to work 
out why the date on the 
Minerva clock was always 
slow when | reset it, until | 
noticed that the time has to 
be reset in the Mini-config 
program. This and your 
request for reviewers for cer- 
tain programs recently leads 
me to suggest that you 
should run two review 
teams. One is “the experts’, 
who can read the manuals, 
extract the relevant informa- 
tion and run the program 
first, and the other, a collec- 


tion of people who, like me 
(there must be plenty of oth- 
ers) get totally lost in the 
instructions and technical 
language. 
| can, eventually, get things 
happening. Having rewritten 
the Boot file about twenty 
times, | now have QPAC2 
running beautifully and my 
problems with SERmous 
only occurred because | did 
as the adverts suggested 
and bought a cheap mouse. 
(Jochen Merz supplied me 
with a better one, and now 
that is wonderful as well) So 
maybe reviews by people 
like me might be a good 
idea to show the obvious 
mistakes that the experts 
would immediately notice 
and cure without a mention. 
Roy Wood 
Hamburg 
Germany 


We try to make sure our 
reviewers refer to the manu- 
als and discuss them, so 
that if they are hard to 
understand, people will be 
warned. We strive to give an 
idea how good the software 
is overall, as everyone has 
some difficulties with new 
programs, often for reasons 
of compatibility with printers, 
or personal misunderstana- 
ings which it would not be 
fair to highlight in a general 
review. However, we want to 
know if anyone has persis- 
tent difficulties. Always get in 
touch with the manufacturer 
first if you have a problem. 
Most QL suppliers give 
good support (as every sup- 
plier should). 

Your method of writing a 
Boot program - doing it 20 
times over until it works well 
- would strike many of us as 
absolutely correct! There is a 
lot of “if at first you don't suc- 
ceea” in programming. 


TRA 


| was hoping to see the 
definition of the Basic com- 
mand TRA in the useful 
series the New User Guide. 
True, not all roms support 
this, but JS (presumably 
quite widespread) does. | 


find the command useful for 
printing such characters as 
“up arrow’ and “right arrow’ 
on my Epson printer. Indeed, 
there is oblique reference to 
TRA in the section CRE- 
ATE_PRINTER_DRIVER in 
Digital precision’s manual for 
Perfection. So for those who 
are interested (and there 
must, or should in my opin- 
ion, be many users of 
Perfection) here is my defini- 
tion of TRA unravelled from 
its machine code. 


TRA address1 [address2] 
(US and above) 
Translation Command 


This command controls 
two tables, Serial Translation 
and Message. The first 
translates output to SER1 
and SER2, the second pro- 
vides the error messages. 

The default table trans- 
lates each byte to itself (ie it 
does nothing). This can be 
changed by specifying in 
address1 the position of a 
user table. This should con- 
tain the 7 bytes 
74,251 ,0,6,1,6,0 followed by 
255 bytes being the transla- 
tion of bytes 1 to 255. (Note 
that byte O is never altered) 
After this is an extension 
table. If any byte in the trans- 
lation table is zero then 
three bytes are taken from 
the extension table which is 
made up of a byte giving the 
number of translations fol- 
lowed by that number of 
groups of four bytes, the first 
of which is the byte to be 
translated, the remaining 
three being the three bytes 
actually sent to SER1 or 
SER2. 

lf address1 = 0, no change 
is made to the current 
Translation Table. 

lf address1 = 1, the 
Translation Table reverts to 
the default. 

Otherwise address is 
taken as the address of the 
new Table. 

A user Message Table 
can be set up by putting 
address2 equal to the 
address of a user table. This 
table must start with the two 
bytes 74,251 followed by 29 


words giving the offset of 
each of the 29 messages 
frost he start of the table. 
Each message except the 
last two consists of one 
word containing the length 
of the message followed by 
the message itself. The last 
two messages have no ini- 
tial defining word. In fact, 
only 21 of the messages are 
true error messages, so the 
others ought to be copied to 
end of the user table from 
the default taxable. The 
address of the Message 
Table is held in SYS_VARS + 
$14A (usually $281 4A). 

lf address2 = 0, the 
Message Table reverts to 
the default 

lf address2 is omitted, no 
change is made to the cur- 
rent Table. 

Otherwise address2 is 
taken as the address of the 
new Table. 

George Gwilt 
Edinburgh 
Scotland 


Back Numbers 


In Issue 10 | read of 
requests for back numbers 
of QLWorld. | have all copies 
of QLWorld, QLUser (includ- 
ing the Special Launch 
Edition) and QLUB News 
issues 4-8... | am willing to 
supply photocopies of 
requested articles. | do not 
have my own photocopier, 
but a local business will 
make copies for contribu- 
tions to charity of 10p a 
sheet, and these could be 
supplied at that prrice, plus 
price of a large envelope 
and postage. | have my own 
index of articles, not perfect 
but | can usually find things. 

On my copy of D-Day the 
first request is “Is there a 
ram disc available?” I,m sure 
there is but | don't know how 
to find it. Words of one sylla- 
ble, please. 

Arthur Nunn 
Ripon 
0765 689378 


Editor’s Notebook 


If any of the editorial pages look odd this 
month, it’s quite likely to be my fault, as | have 
entered most of them, in the nightmare compa- 
ny of Hell's Monitor, which kept fading back into 
the darkness. whence it came. We examined its 
insides and threatened it with a major operation, 
and that seems to have settled it for a while ... 

This month we have news of an interesting 
new indexing program from Dilwyn Jones, and it 
looks as if Miracle, faced with directing their 
energies in many different difrections, are mak- 
ing determined plans to be in full control of as 
much of their sfotware, as well as their hardware, 
as possible for future developments. They also 
expect to have the first-demo SCSI card ready 


for Newport in May. 


Please note that Qubbesoft’s workshop num- 
ber is 0376 347852, and not the one printed in 
last month’s QLScene. Sorry, Ron. 
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Bryan Davies looks at the habits of computer founts. 


ull marks to Hewlett- 

Packard for service. 

Alf Kendall has an H- 

P DeskJet printer, 
which went sick a few 
months back. He thought 
the printer was no longer 
covered by warranty, being 
more than one year old, but, 
when he contacted Hewlett- 
Packard he was asked for 
the printer serial number 
and told it was still covered. 
The printer was duly collect- 
ed - yes, H-P arranged for it 
to be picked up - on a 
Friday. It arrived back, work- 
ing properly and with several 
parts replaced, the following 
Friday. This was a couple of 
weeks before Christmas, 
when one can usually 
expect delays. Advice with 
the printer told him the war- 
ranty extends until spring 
1994, well past the end of 
the one-year nominal war- 
ranty period. As you might 
expect, Alf is a very satisfied 
customer. 

The DeskJet is a good 
printer, and justifiably popu- 
lar. There can be problems 
with the ink feed if the 
machine is not used regular- 
ly. As with most inks, 
DeskJet cartridges can clog, 
so keep it flowing freely by 
printing the odd page every 
few days. If the printer has to 
be left inactive for weeks, 
remove the cartridge, and 
cover the nozzle area; it 
might also be worth putting 
the cartridge back into its 
packet and sealing that with 
tape as tightly as possible. 

Ink cartridges are expen- 
sive, but the costs can be 
kept down with refills. Rather 
than waiting until nothing at 
all is coming out of the noz- 


zles, inject a little ink into the 
cartridge at regular intervals. 
A refill equivalent to the 
amount in two new car- 
tridges costs about £8-12 
plus VAT. 

My experience with the 
Canon BubbleJet BJ-10EX 
is that a cartridge left for 
months without use is too 
far gone to be worth trying to 
revive with a refill kit. You 
can get it printing again, but 
the quality is not good. 
Possibly, soaking the car- 
tridge in a suitable solvent 
for several hours would do 
the trick if you have more 
time than money. 


Printer Founts 


Bryan Orgar is puzzled by 
founts. Like most micro 
users, he is attracted to 
improving the appearance 
of his printed output, but 
finds it difficult to understand 
the terminology and tech- 
niques. Printing causes 
more heartache for most of 
us than any other facet of 
home computing, but life 
“before founts” was a whole 
lot simpler than it is now. 

Printers come with “built- 
in” founts. These appear on 
the test prints, which can be 
done without the printer 
being connected to a com- 
puter at all. These founts are 
comparable with those on 
the screen of the basic QL, 
as they are ‘library sets” of 
characters, default founts. 
Over the years, the built-in 
founts have increased and 
improved, and even fairly 
cheap dot matrix printers 
now have a reasonable set 
of founts. However, many 
people are not satisfied with 
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the basic founts, and look 
around for additional ones. 
This is where you get on 
the slippery slope. There are 
two main categories of addi- 
tional fount - those on plug- 
in fount cards or cartridges, 
and “soft founts”. As the 
name implies, plug-in cards 
contain extra founts, which 
effectively increase the built- 
in set. These founts act just 
like the built-in ones. One 
major drawback of founts on 
cards is their cost; they usu- 
ally work out far more 
expensive than software 
founts, and | never recom- 
mend them, for this reason. 


Downloading 
Founts 


Software founts come in 
several varieties, but the 
general principle of opera- 
tion is much the same. The 
fount characters are stored, 
or generated, in the comput- 
er and “downloaded” to the 
printer. The manner of down- 
loading is not the same for 
all types of soft fount. One 
technique is to send com- 
plete fount sets to the printer 
before printing starts, or as 
required during printing. This 
may need plenty of storage 
in the printer, fount files can 
take up a lot of space, 

Some types of printer have 
little or no memory available 
for storing founts. Dot matrix 
printers and inkjets come 
with far too little memory for 
whole sets of characters to 
be stored. For these, it is 
necessary to send fount 
characters more or less one 
by one, rather than whole 
libraries at once. There are 
considerable variations in 


speed between different 
techniques. Downloading a 
whole fount is a time-con- 
suming business but, once 
it has been done, the founts 
become effectively built-in 
and there is no great delay 
in printing from there on. 
Sending characters individu- 
ally means having to send 
some of them repeatedly, 
and this is a slow process. 

Soft founts can be stored 
in the computer as library 
sets, just as the basic founts 
are stored in a printer, 
except that the soft founts 
will be on hard disc whereas 
the printer ones will be in a 
rom chip. A big disadvan- 
tage of the library fount is 
that it has to be of a fixed 
size. For instance, Courier 
10-cpi (characters per inch) 
is one of many fixed sizes of 
the Courier fount, and can 
be stored in one fount file. If 
you want 12-cpi as well, that 
means another file. Add 
together the founts you want, 
and the sizes in each, and 
you arrive at quite a few files. 
File size tends to increase 
with Character size, so that 
different sizes of the same 
basic type (eg Times) can 
range from, say, 10 KB up to 
100 KB. 

An alternative is to gener- 
ate each size on demand. 
This is what happens with 
scalable founts. The basic 
designs of the characters 
are stored, as a collection of 
mathematical definitions, 
without any size being 
attached to them. When the 
request comes for a particu- 
lar size, the appropriate mul- 
tiplying factor is applied to 
produce the desired size. 
The resultant character is 
sent to the printer. This is a 


very flexible approach, which 
gives good quality print over 
a wide range of sizes. The 
fact that the characters are 
not stored as dots in a 
matrix means that enlarging 
them does not result in a 
corresponding increase in 
jagged edges. 


Scalable 
Founts 


Scalable founts do not 
have to be soft founts. They 
can be “firm founts’, stored 
on firmware (on a chip). 
Some types of printer - 
notably inkjet and laser - 
come with built-in scalable 
founts. These are invariably 
preferable to the fixed-size 
founts which were standard 
in dot matrix printers for 
many years (and still are in 
cheap printers). 

Before switching to a laser 
printer, | had thought that the 
dot matrix printer had some 
advantages, but that idea 
soon disappeared. In almost 
every way, the dot matrix 
printer is less flexible. 
Perhaps the only advan- 
tage is the ability to take 
continuous stationery. Even 
the ribbons can be very 
expensive, comparable in 
price to ink cartridges and 
laser toner. The cost of a 
colour ribbon for the Star 
LC24-200, for example, is 
about £10-11 plus VAT, and 
| am told that they do not 
last long. There are some 
inherent design weaknesses 
in dot matrix printers which 
cause trouble. One is the 
inability to print near to top 
or bottom of paper, because 
of the physical spacing 
between print head and bail 
bar, and the need to have 
enough paper to grip to 
keep it aligned. Another is 


~ noise. 


Inkjets have their faults, 
too. They tend not to have 
emulation modes compati- 
ble with your existing printer; 
this can make them unus- 
able if your application pro- 
grams do not have your 
specific printer drivers. You 
cannot simply use an Epson 
FX-80 driver and get at least 


a basic printout, as you can 
with most dot matrix printers. 

In principle, dot matrix 
printers can print the same 
soft founts as inkjet and 
laser printers. Bryan Orgar 
has a NEC Pinwriter P2200, 
which is usable with many 
soft founts. The difficulties 
arise with individual applica- 
tion programs and their 
printer drivers - or lack of 
them - and with individual 
founts. Bryan also uses 
WordPerfect, and he should 
have no great trouble finding 
a Suitable driver for that pro- 
gram. 


Create Printer 
Data 


However, he prefers his 
Perfection SE to 
WordPerfect. Digital 
Precision do not have a vast 
stock of drivers, but they 
allow you to custom-build 
your own, using their Create 
Printer Data routine and 
inserting the appropriate 
control codes for your print- 
er. This can be be painful 
with some printers, such as 
the H-P lasers, but should 
be no great job with the 
P2200. DP will give advice 
on creating drivers, but don't 
expect them to spend hours 
writing one for you at no 
charge. 

The Perfection driver can 
utilise the Strip function to 
enable the various built-in 
founts to be selected. As 
yet, the QL has not been 
favoured with masses of 
soft fount programs. We 
have had plenty of founts 
offered, but they generally 
are unusable by the aver- 
age person, because they 
are not automatically 
made available to the 
application programs. They 
can be made to replace 
the on-screen QL founts, 
which may create a pleas- 
ing visual effect but is no 
use for printing. 

Text87 has a graphics 
driver which enables the 
founts supplied with it to 
be printed exactly as they 
are displayed on the 


screen, a rare genuine 
WYSIWYG (what you see is 
what you get). There used to 
be a very good program 
(CuePrint) which provided 
masses of well-designed 
founts for dot matrix printers, 
but that program is, alas, no 
longer available. For the 
moment, there is no doubt 
that you are better off with 
an inkjet or laser printer, sim- 
ply because they have better 
built-in, and scalable, founts. 
Make sure your application 
program supports the printer 
you choose, though. 

When thinking about soft 
founts, you may need to 
forget characters as dis- 
crete ready-made objects. 
The tendency now is for 
text to be printed as graph- 
ics: each character is cre- 
ated, and sent to the print- 
er, as a “picture”. 

The expression “soft 
founts” was coined to 
describe library character 
sets. The main difference 
between soft founts and 
built-in printer ones is that 
soft founts are stored in 
the computer. 

On the other hand, 
graphics founts, such as 
those used with the 
Windows interface, are 
“soft” in that they are creat- 
ed by software, and are 
stored on hard disk, but 
the characters are trans- 
ferred to the printer as indi- 
vidual images. Some 
founts have both screen 
and printer files, but the 
Windows type now gener- 
ally use the same files for 
display and printing. 


Graphics 
Printing 


It is easy to be overcome 
by the wonders of new 
founts, but do not lose sight 
of the down-side. Graphical 
printing is usually much 
slower than printing with 
built-in characters - this 
makes a lot of difference 
when you take into account 
that the QL can be speeded 
up very little when printing 
graphic images. 

Using built-in founts is 


much faster. Also, text 
quality sent graphically 
from the computer to a dot 
matrix printer can be 
mediocre on paper, worse 
than built-in founts. You 
can trace a path of decline 
for print quality, from the 
typewriter-quality of the 
daisywheel, down to the 
near-letter-quality on the 
dot matrix, down to graph- 
ic text to the dot matrix. 

Laser and inkjet printers 
do a very good job of print- 
ing graphically; much bet- 
ter than even a good dot 
matrix printer does. 


Odds and Ends 


The word has been 
passed to me that my 
chemical terminology is 
out of date. Specifically, 
isopropyl alcohol is now 
normally referred to “in the 
trade” as isopropanol. 
Likewise with ethanol, 
methanol etc. If you hap- 
pen to be a drag-racing 
fan, methanol should have 
been a familiar term for 
many years, but literature 
on disk cleaners doesn’t 
often use the term iso- 
propanol. Now we know. 

The liquid itself is an 
evaporating alchohol 
cleaner, used in disk drive 
kits to clean the recording 
heads. It can be used for 
many other cleaning jobs, 
such as on the record 
heads of microdrives. It 
appears not to be strong, 
in the sense it is not liable 
to damage surfaces it 
comes into contact with, 
making it fairly safe to use 
for cleaning plastics. 

A supplier called Furst (?) 
is said to be offering the 
SMS2 operating system on 
rom chip for the Atari, at a 
price of about £135. There 
is a dedicated rom socket 
on some Atari mother- 
boards, and the SMS2 chip 
fits into that; this approach 
sounds to be somewhat 
different from the QL emu- 
lators sold up to now. | 
heard this on the 
grapevine. Has anyone any 
more details? 
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The future now? 
Wolfgang Lenerz 
uses the QL 
emulator for the 
Atari STe. 


INFORMATION 

Prices: QVME card: DM 
695 

Adapter: DM 90 

Supplier: Jochen Merz 
Software, Im stillen Winkel 
12, D-4100 DUISBURG 11 
Germany 


or some time, the 
Atari emulators 
were the best and 
only way to get a 
better, faster and more reli- 
able QL: buy an Atari, install 
an emulator card (which 
involved some brandishing 
of the soldering iron), and 
the Atari behaves like a QL 
As the Atari had a true 
68000 (instead of the QL’s 
68008) it was noticeably 
faster than the QL, especially 
in printing to the screen, as it 
is not hampered by the QL’s 
double access to the screen 
memory. A Mega ST with 4 
MB memory and a hard disk 
makes a formidable QL! 


= 
(S) 


When Atari brought 
out the STe (which is 
faster than the older ST 
series, being a 16 MHz 
machine), everybody 
waited for Jochen Merz 
to come up with an 
emulator for that 
machine - the old emu- 
lators would not work 
with it That new emula- 
tor is finally here. It was 
very long in coming, 
and | suppose that Merz 
lost a few sales to the 
Gold Card by then (he 
says he didn’t). It is 
called the QVME card, 
because it plugs into 
the “VME bus” of an 
Atari Mega STe. 


On The Card 


There is not much to 
say on the physical 
description of the QVME 
card. As you can see 
from Figure one, it is 
neatly finished, with a 
VME connector at one 
end. | confess that | was 
astonished by the num- 
ber of chips on it - the 
board is densely popu- 
lated, even though it 
uses high integration. It 
is a very professional 
product, there is no evi- 
dence of last minute 
tampering, or wires run- 
ning where they 
shouldn't. 

Nice as the card may 
be, were it just another 
emulator, only adapted 
to the STe series, it 
would hardly be impor- 
tant enough to merit a 
review in QL World. But 
there is more to it. 

First of all, installation 
is very much simplified: 
The card simply plugs 
into the STe’s VME bus. 
No soldering is required. 
The QVME card can 
only be used in Mega 
STes, as the 1024 STe 
does not have a VME 
bus. Given the country 
of origin, this apparent 
restriction of choice is 
not surprising: In 
Germany, the majority of 
Atari machines sold 
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were Mega ST(e) machines. 
There, the Atari was more 
seen as a (small) business 
machine, whereas in Britain 
it never really got over the 
games machine image. 

It should be emphasised 
that Jochen Merz also sells 
a Mega ST adaptor, so that 
those having an older Mega 
ST can also use the QVME 
card (one wire needs to be 
soldered in that case). This 
is the case for me: | have a 
Mega 4 ST, and with the use 
of the adaptor, | can use the 
QVME card. This is the con- 
figuration actually used to 


Figure one: The QVME card 


write this review. Figure two 
shows the card comfortably 
installed inside the machine. 


Large Screen 


Once installed, the card 
must be connected directly 
to the monitor. Indeed, the 
QVME card is actually a 
fully-fledged graphics card 
for the STe which replaces 
the latter's internal circuitry. 
(Drivers to use it in Atari 
native mode are also provid- 
ed, but this does not work 
on ST machines, one needs 
a genuine STe) The reason 
for such a graphics card is 
that it can display resolu- 
tions much higher than the 
Atari can: resolutions up to 
1024x768 are possible - 
even in QL mode: more 
than four times the native QL 
screen! 


Of course, one will need a 
suitable monitor, a multisync 
being the best. Monitor size 
is also important. A 14 inch 
monitor can't really go much 
higher than the 832x416 res- 
olution in Figure three, or 
the letters are too small for 
comfort. With a 17-in mgni- 
tor, that should be possible, 
though. A normal QL moni- 
tor will not be able to display 
a very high resolution 
screen, but an ordinary VGA 
screen will be able to dis- 
play at least 640x480 - not 
bad, considering how cheap 
VGA monitors are today. 
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with its VME connector. 


The QVME card does 
work with a normal QL mon- 
itor - but you will need to 
have someone make up a 
plug, as the card only has a 
‘normal’ (for the PC world 15- 
pin plug. Even on a normal 
QL monitor, it is possible to 
get resolutions higher than 
the normal QL resolution. 


Adapting 


To adapt the card to your 
monitor, a whole suite of 
new keywords are linked 
into Basic. These allow you 
to change resolutions, verti- 
cal and horizontal frame fre- 
quencies, vertical and hori- 
zontal overscan etc... 

Fortunately, these new 
keywords and their purpos- 
es are well explained in the 
manual. Initially, the screen 
will be set to QL compatible 


resolutions and frequencies, 
it is thus a matter of includ- 
ing a few more lines of 
Basic in your boot file to 
change these. Once one 
has found a correct set of 
values, these can be pre- 
configured, so that even the 
Basic lines in the boot 
become obsolete. 

How does one find the 
best values? By trial and 
error - increasing (for 
example) the resolu- 
tions ever so slightly, 
until finding a suitable 
one. This raises two 
interesting points: 

First of all, this 
method seems a bit 
fussy: wouldn't it have 
been better to give a 
table with standard 
values? Perhaps the 
reason lies in the fact 
that there are too 
many different monitor 
types. Here, the manu- 
al gives a very stout 
warning: do not try to 
use frequencies higher 
than the ones support- 
ed by your monitor, 
else you can (and willl) 
physically damage it. The 
manual adds: “Take this 
warning seriously!” So you 
have been warned. This is 
probably why it is left to 
each user to select the best 
frequencies for his/her moni- 
tor (you will need your moni- 
tors manual for that). 


Size Changes 


Second and incredibly, the 
display changes to the new 
size aS SOON as One types 
the Basic commands: it is 
possible to change resolu- 
tion ‘on the fly - and all soft- 
ware continues to function! 
Multitasking really takes on 
anew meaning as it is pos- 
sible to display several jobs 
at once. Likewise, there is 
now space enough to dis- 
play a very large list of files 
on the hard disk, without 
having to scroll through too 
many of them (see Figure 
four). 

When programming, those 
using QD are also happy, as 
the window of that editor 


can be enlarged, so that 
one can see many more 
lines at a single glance. 

So what is using the card 
like? First of all, having a 
high resolution QL (after all, 
that is what it boils down to) 
is addictive! At last there is 
enough space for a whole 
row of buttons at the top of 
the screen (see Figure 
three), visually recalling the 


jobs running in my machine. 
It also becomes realistic to 
leave many window open, 
as somewhere part of it will 
show and thus can be 
‘picked’ quickly with the 
mouse. With a large screen, 
multitasking gathers a new 
dimension. This enables me 
to integrate the computer 
even more into my business 
life. | have written a suite of 
programs to assist me in (or 
automate) most material 
aspects of my law office 
(mainly follow-up of cases, 
accounting, standard letters 
etc). Now the AtaQL reflects 
even more closely the way | 
work, compelled (through 
telephone calls, urgencies 
etc.) to switch quickly from 
one task to another. In that 
sense, | can certainly say 
that the larger screen is - for 
me - a productivity tool. 


Several Things 


In addition to the possibili- 
ty of seeing several things at 
once, it also becomes possi- 


ble to see more (of a list, a 
letter, a deed etc) at once. 
This, again, soeeds up my 
work - nothing can beat the 
humain eye/brain combina- 
tion to pick up fast salient 
facts from a screenfull of 
lines. Unfortunately, however, 
this latest possibility is still 
restricted: not all programs 
can make use of the large 
screen; only a few do. They 


Figure two: The QVME - a QL card installed in an Atari STe. 


run, but they still assume the 
the maximum screen size is 
512x256. Some programs 
(such as the QPAC 2 suite, 
QD, Qspread and so on) 
allow their screen size to be 
altered and of course, these 
programs can take advan- 
tage of the large screen. 
With one exception, they 
invariably run under the 
pointer environment. The 
exception is Text87 - it will 
adjust to a larger screen, 
even though it is not a point- 
er environment product. For 
various reasons, | don’t use 
Text87, and my biggest 
lament is that | don’t have a 
wordprocessor showing me 
more of a page! 

One aspect of interest 
might be the screen updat- 
ing. We all know by now 
that, in the QL, screen 
access is rather slow. On the 
Atari, this is not the case, so, 
compared to the QL, 
scrolling a page up or down 
in blindingly fast. With a larg- 
er screen, however, scrolling 
speed goes down again. 


This is easily explained. 
Suppose one scrolls the 
screen down by one pixel 
line. This means that the 
entire screen must be 
moved down one line. At a 
normal QL resolution of 
512x256 pixels in 4 colours, 
the processor must thus 
move 512*256/4 bytes (there 
are 4 pixels to a byte in 4 
colour mode) = 32768 
bytes. When using (say) 
a 1024*512 resolution 
with the card, the 
processor must move 
1024*512/4 bytes = 
131072 bytes, i.e. four 
times as much a nor- 
mal QL! Despite that, 
scrolling on an AtaQL is 
still fast - as fast as a 
normal QU 

Of course, there are 
some other niggles. To 
my mind, they are 
minor, but | know of oth- 
ers who do feel incom- 
moded. Perhaps the 
most lamented is that 
the emulator only allows 
Mode4. There is no 
Mode8 at all. | may be 
wrong, but to my knowl- 
edge, the only programs 
using Mode8 are graphics 
programs, or games. | only 
rarely use the former - and 
the games | play work in 
Mode4. As | never use 
Mode8, | can honestly say 
that | don’t miss its absence 
at all. 


Compatibility 


Also, there are some com- 
patibility problems: no pro- 
gram writing direct to the 
screen will work - the screen 
address does not lie at 
$20000 as in the QL. It 
seems to be somewhere in 
high memory. But there 
again, the majority of pro- 
grams writing direct to the 
screen are games... It must 
also be mentioned that 
some programs, even 
though they write directly to 
the screen, can be persuad- 
ed to run nevertheless: such 
as the Psion suite, all of 
which (except Easel, for 
obvious reasons) can run on 
the emulator. Indeed, in fig- 


Sinclair QL World Vol. 3 Issue. 1 I 3 


ure three, you can see Quill, 
being used to type this 
review (actually, | cheated, 
because the is the Quill of 
Turbo-Xchange, which can 
also be persuaded to run on 
the emulator). 

Another potential source 
of trouble could be the 
pointer environment, which 
is automatically loaded into 
the machine. | personally 
think that the pointer envi- 
ronment is the best thing to 
have happened to the QL 
since its inception. | would 
actually refuse to work with a 
machine that didn’t have it 
loaded, but there are some 
people who can’t get to 
grips with it. 

| also have an unfulfilled 
wish. It is clear that the card 
can only display four 
colours. It would have been 
very nice, however, if | could 
choose what these colours 
were! The reason for that? 
Well, it would be nice to be 
able to replace the colour 
green (or red) by a grey. This 
would not make much differ- 
ence to already existing pro- 
grams, but | could then use 
white, black and grey to 
achieve some neat 3D 
effects in programs | write 
myself! Unfortunately, the 
colours are hard-coded in 
the QVME card, so that is 
not possible. 

All in all, though, these crit- 
icisms are minor. For me, the 
situation is simple: there is 
no program available on the 
QL which | would like to use, 
but which | can't use 
because of incompatibility 
problems. The emulator is in 
my machine to stay! 


Future? 


The card addresses the 
point | perceive to be the 
biggest disadvantage of the 
QL: the screen. Indeed, if 
one looks at other comput- 
ers today, what most QL 
users find striking, is their 
display. Most software devel- 
oped today for, notably, PCs 
using Windows, just looks 
nice. Never mind, here, 
whether that software works 


PRE 


Segue SPs 
TES eRe 


RES ie GU ~ oe WAL, Hf wRidiite ur Be eedien semen, 


BE PER Le bon 9B 
SS WR Sn U4 VB 


B.A 
BREE Sant ig, metie aed $55 
Be reahig sites 4 Shs 
ADH seg. aeons inte 
RE USF sibiotan 
SARE Loh tp, poles ty nex 
EB 9. Sots xe 


£ sutpte.: et. shen ae 

E wilpir contig. outer yen dos 
© saitede catty. mote my, soe 
£ ontete contig sete 158 


Sapte set SUTRAS dese 
PAE ape wi base xe 
wipe ert exe cigbin 
Spe aget somepln des 
PUQRY _apek terest, fore 
BOK wert Hens? fas 
BAR Ort HONG Des. 
BEOD SE sith BOF 
REPRE PBEK SE 
GER MR RG os 


£ netpte rontig webe 1Y 8 
E aiskyte cmt ing secker, Ree 

£ seria contig, wae, ES 
£ oreo tmbiy Sapte we 

£ wetpte contig simple gon BR 
E tpi awed SR tReet gett 

© eedhpie srt Be Mort i 

& suinix sgt Picheit ot 


Figure four: A very large list of files can be displayed at once. 


(much of it doesn't!) or does 
things you couldn't do with 
the QL (as is often, and very 
wrongly, stated) - the fact is 
that it is often pleasant to 
look at, heightening the 
interest in the program (and 
the computer). | firmly 
believe that it no longer is 
enough for a modern pro- 
gram to do what it sets out 
to do - it must also do it in a 
visually pleasing manner. 
This is difficult to achieve on 
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a normal QL display! It is 
incredible that a modern 
computer (and, even after 10 
years, the QL is still that!) 
should only have a highest 
resolution of 512x256 in 4 
colours. The QVME card cer- 
tainly puts that right! 
Moreover, due to a unified 
interface system, modern 
software on other (lesser!) 
computers is also often 
more easy to use - but if 
every QL developer could 


only be made to develop 
under the pointer environ- 
ment, the QL could also 
have that! 

The debate over the future 
of the QL has been going 
on for some time now, and it 
is no accident that the QXL 
card should be out soon. 
For those QL users having 
Mega ST(e) computers, the 
QVME card could be the 
best way to have that future, 
now. 


the NEW USER GUIDE 


oncepts 


Section 


This month we begin the Hardware 
section of the Concepts guide. 


he original Sinclair QL User Guide’s Concepts sec- 

tion was an alphabetical mix of the trivial, the valu- 

able and the arcane. Topics were not inter-related 

and the content was somewhat haphazard. The sec- 
tion on QDOS, for instance, is both inadequate for a 
machine code programmer and inaccessible to a 
SuperBasic programmer. The topic on peripheral expansion 
included the necessary disclaimer that the author did not 
expect QL users to make their own expansion devices 
based on two pages of text, but justified its presence as a 
way of gaining a basic understanding about the expansion 
mechanism. Potentially useful subjects such as arrays are 
dismissed in a few lines. The original Concepts section is 
unclear about its audience, arbitrarily assembled, and ulti- 
mately failing in its intended purpose. 

The Concepts section in the New User Guide began last 
month with an overview describing the relationship between 
the layers of a computer system. The remaining sections 
will be dealt with in the following sequence: hardware, oper- 
ating system (QDOS) and programming (SuperBasic). The 
New User Guide's reader is the intelligent non-specialist QL 
user who wants to make SuperBasic work but is not willing 
to be buried under technical minutiae. Cross references to 
other QL World articles are included for those who want to 
go further. 


HARDWARE 


Communications 


The QL communicates with the outside world through a 
variety of ports, sockets and connectors. These fall into two 
major hardware categories: simplex devices that permit one- 
way communication only and duplex devices that allow two- 
way communications between device and computer, some- 
times only in one direction at a time (known as halfduplex 
mode). 

The simplex input connections are the keyboard (techni- 


cally a peripheral), and for games joysticks (CTL1 and CTL2). 
The keyboard connector lies in the centre of the mother- 
board and is only accessible by unscrewing the body and 
carefully lifting the cover. Two ultra-thin ribbon connectors 
thread their way from the keyboard mat (for which the only 
benefit ever claimed was that it survived coffee spills) into 
two long, thin sockets. If they become detached they are a 
devil to force back in. 

Plenty of alternative keyboards have been, and are still, 
available. Advanced keyboards replace the QL’s original 
6502 controller chip and link to any standard, PC-compati- 
ble, 102-key keyboard. This approach is a little more techni- 
cally demanding than replacing one pair of ribbon connec- 
tors with another, but has the advantage that signal timing 
problems affecting the serial ports are avoided. These days, 
many QL owners use an external keyboard because they 
are more comfortable and offer numeric keypads and 
improved key-mapping (for instance, the Pause key emu- 
lates Shift-F5 to interrupt screen scrolling). 

The 9-pin Atari “D” connector games joystick ports, CTL1 
and CTL2, have by and large been forgotten by QL users as 
little use was ever made of them. Games written for two joy- 
sticks, such as Psion’s Tennis, can also be used from a 
shared keyboard. Signals from the games ports can be read 
by KEYROW( to emulate the following keyboard presses: 


ACTIONCTL1CTL2 

Joystick upup cursor keyF4 
Joystick downdown cursor keyF2 
Joystick leftleft cursor keyF1 
Joystick rightright cursor keyF3 
Fire buttonspacebarF5 


The only simplex output device is the picture socket. This 
is a multi-ourpose 8-pin DIN socket with output compatible 
with TTL colour, monochrome video, PAL and composite 
sync. Figure one (over the page) shows the layout of the 
socket as it is seen looking at the socket in its position at 
the back of the QL The connector at the other end of the 
picture-carrying cable depends very much on the type of 
monitor in use. At least one type of monitor rather danger- 
ously sports an identical 8-pin DIN socket to the QL’s but 
with an entirely different pin-out. Connecting the cable the 
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wrong way round can destroy the computers picture-gener- 
ating components. 

The half-duplex connections are the rom port at the rear 
left of the QL, the large expansion port on the left of the cas- 
ing, the two network sockets near the power socket, and the 
serial ports in the centre of the computer's rear panel. 

In the early days, the rom port was occupied by overspill 
hardware for the operating system and SuperBasic, univer- 
sally known as the Kludge. More recent and happier times 
have seen the rom port used by QDOS extensions such as 


7. Red TTL 
3. PAL colour video 
5. (nc) 


8. Blue TTL 


2. Common ground 


QL multi-format video socket 


Lightning and SuperToolkit Il, language enhancements such 
as MetaCompco's C compiler, and even device connectors 
such as a MIDI music port and a hard disk controller. One- 
to-many units used to be available to allow more than one 
external rom to be present at a time. Installation is a simple 
matter of removing the cover plate and inserting the rom into 
the waiting edge connector, but QLs are well-known to 
resent frequent changes of occupant in the rom port. 

It is a rare QL that does not have something, usually from 
Miracle Systems, hanging from the expansion port to the left 
of the QL body. Some of these expansion devices have a 
“through port” to allow others to be daisy-chained to them. 
One of my QLs, for example, has an Expanderam card and 
a Miracle disk drive controller attached, making the system 
66cm wide. The latest favourite for the expansion port is the 
Gold Card. Installation of any peripheral through this port is 
easy, although care needs to be taken: it is best to remove 
the lid of the computer entirely so that you can be absolutely 
sure that the 64 pins line up precisely with the 64 holes in 
the QL’s socket. 

The serial ports are, to most users, the printer ports, and 
are only used for simplex traffic to drive a printer. Serial 
cables, where files are passed bit by bit down a single piece 
of wire, are notoriously slow and difficult to set up. The sim- 
plest solution to most printing problems is to fit a serial to 
parallel converter, the device that set Miracle Systems on the 
road to fame. The QL thinks it is talking across a serial 
device using its default settings, but the signals are 
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6. Green TTL 


1. Mono video 


4. Composite sync. 


processed inside a small box from which they emerge ona 
parallel cable with each bit in its own wire. Printers receive 
the information synchronised byte by byte, which is faster 
and more secure. 

The QL can accept mouse input through one of these ser- 
ial ports, provided that QDOS has been extended with 
mouse-aware utilities such as those in the QPTR software. 
Other uses for the serial ports are to link to modems and to 
perform file transfers with other computers, notably the IBM 
PC, the BBC micro and the Sinclair Z88 portable. In these 
circumstances the port is used in half- 
duplex mode so that information travels in 
either direction. 

Serial ports are deemed to be connect- 
ed to DCE or DTE devices (Data 
Communication Equipment and Data 
Terminal Equipment respectively). 
Although in the mainframe world where 
serial protocols were developed it is clear 
which device is which, there has always 
been confusion with microcomputers that 
can at once be a DCE in relation to their 
printer and a DTE in relation to a main- 
frame connection. The QL embodies this 
confusion by configuring the SER1 port as 
a DCE and the SER2 port as a DTE, so 
you can take your pick. For printing, 
though, SER1 is the obvious choice. 

Physically, the serial ports are telephone 
RJ11 sockets. When the QL came out this 
was thought by many to be an outrageous cost-cutting exer- 
cise, but the socket is very reliable and has since become 
widely copied by other systems, including the latest PC net- 
work structured cabling hubs. The QL’s ports can be set to 
run at speeds of up to 9,600 baud (or transmit on 19,200 
baud), but the speed cannot be set independently for each 
port. See the BAUD command in the New User Guide 
Keywords Section for further detail. 


Useful references: 


Keyboards: SQLW Feb 91 page 34, Apr 91 page 34, Jan 
93 page 20 

Monitor connections: SQLW May 87 page 25 

Gold Card: SQLW Jun 92 page 22 

RS232 serial interface: RS-232 Made Easy by Martin D 
Seyer published by Prentice-Hall, ISBN 0-13-783472-1 


Storage Devices 


The working memory of a QL is volatile: when you switch 
off the computer, you have 0.02 seconds to restore power 
before everything stored in random access memory disap- 
pears. An essential part of the computer is therefore a 
means of storing information somewhere where constant 
electrical power is not required to keep the binary informa- 
tion intact. 


To begin with, the QL relied on microdrives, Sinclair's 
unique serial-storage format. Later improvements included a 
variety of floppy-disk formats and even hard disk drive units. 

The microdrive cartridge contains a continuous loop of 
about 56cm (22 inches) of video-quality magnetic tape. The 
tape spools up through the centre of a drum and follows a 
path around the periphery of the casing before being wound 
back onto the drum. At the top of the casing it becomes 
exposed. Where the heads will make contact it is cushioned 
by a small felt pad on a springy metal tab. Should the tab fall 
off it must be replaced if the tape is to be readable. 
Cartridges can be made read-only by removing a plastic tab 
from one side of the casing. Should you change your mind, 
the process can be reversed by applying sticky tape to the 
gap. 

Microdrive cartridges need to be formatted, or divided into 
data segments, before use. The tape is notorious for stretch- 
ing over time, which quickly puts the data segments outside 
the tape drive's limited tolerance. Always format a tape 
between four and six times and reformat your tapes every 
year as a precaution against further stretching. Each sector 
holds 512 bytes and it is perfectly possible to achieve 
between 210 and 220 sectors on a tape, giving over 100KB 
of storage capacity. 

Stretching is also caused by heat. Unfortunately, the 
microdrives are placed close to a heat radiator inside the 
QL’s body, so one of the least safe places to leave a tape 
cartridge for any length of time is in a microdrive slot 

The drives themselves have a mechanically-governed 
electric motor where contact brushes “lift off at around 2,400 
revs per minute. The motor drives a rubber roller that pulls 
the tape past a capstan. Crude adjustment to the position of 
the reading and writing head can be made using a small 
screw mounted immediately below the mouth of each drive 
on the base of the QL Changes should be made cautiously 
and tested for improvements. As a first trial, try tightening 
rather than loosening the screws by half a tum. Always 
remember how many halfturns you have made so that you 
can return to the original settings if necessary. 

Sinclair Research seemed to have a phobia about floppy 
disk drives, which is why no QL rom contains diskette-aware 
routines. Although the drives are more expensive than micro- 
drives, floppy disks are much cheaper than microdrive car- 
tridges and far more reliable. Fortunately, QDOS is very flexi- 
ble when it comes to device types and names and both of 
the expansion ports can be used to link to disk drives of 
some sort. The traditional way is to add a disk controller, 
often with additional ram on board, to the QL’s expansion 
slot. Most QL systems have 3.5-in disk drives of various den- 
sities fitted, but early upgraders also chose to use the older 
5,.25-in disks - the last floppy disk format to be genuinely 
floppy. Floppy disks are made of the same material as 
microdrives, but of a stiffer gauge [and flattened into a disk] 
and magnetically coated on both sides. Formats are Double 
Density (720k), High Density (1.44MB) and Extra Density 
(3.2MB). A system will only accept disks formatted to a 
capacity compatible with both the disk drive and the disk 
controller. The most capable system on the market today is 


Miracle System’s Gold Card, which copes with all these disk 
formats (which is not true even of your above-average PC) as 
well as supporting huge ram expansions and ultra-fast 
access to the QDOS and SuperBasic routines previously 
stored in slow roms on the motherboard. 

While floppy disk drives arrived early and are still very pop- 
ular, hard disks for the QL came late. A hard disk drive is per- 
manently attached to the computer and stores, in the QL’s 
case, around 32MB of data. ABC and Rebel once made 
controllers that attached to the expansion port Miracle’s 
hard disk unit slotted into the rom port and had a through- 
port to daisy-chain another rom. More recent hard disk inter- 
faces, like Jurgen Falkenburg’s, can be connected in a vari- 
ely of ways. 

Hard disks were expensive on a price per megabyte basis, 
and noisy, due to the spinning disk and the cooling fan. In 
the PC world, where 20MB programs are no longer rare, 
large hard disks are essential, but most QL users are better 
served by Extra Density diskettes. These offer the same sort 
of access speeds as hard disks, but are cheaper and more 
flexible in use. QL programs are very compact compared 
with PC equivalents, so a single 3.2MB diskette can store a 
major program and a substantial amount of related data. 


Useful references: 


Microdrives: SQLW Jan/Feb 86 page 36, Mar 86 page 34, 
Jan 89 page 33 

Floppy disk drives: SQLW Jun 86 page 16, Mar 89 page 
34 

Hard disk drives: SQLW May 90 page 14, Sep 90 page 
36 

Gold Card: SQLW Jun 92 page 22 


Roms, Eproms and Expanson 
Boards 


The personality of a QL lies in its system roms, mounted 
on the motherboard. Sinclair Research roms came in pairs, 
but can be replaced by a single Minerva rom. The saga of 
the roms encapsulates all that went wrong with the QL, but 
that story belongs to the QDOS part of the Concepts section. 
The system roms for the QL fall into three categories: the 
early series up to and including AH, the late series of Sinclair 
roms from JM to MG, and the Minerva. The early roms had 
hardware differences which make them difficult to upgrade. 
All roms from JM onwards, including Minerva, are plug-com- 
patible. In other words, you can remove one rom set and 
insert any of the others. Minerva looks different from the other 
roms because it does not fit directly into the motherboard 
socket but sits on a daughterboard. 

Physically, the system roms look like large memory chips: 
the legs fit into sockets on the QL motherboard. Replacing a 
rom involves removing any chance of static electricity 
destroying the components and then levering the old chips 
from their sockets and firmly and persistently applying pres- 
sure to encourage the new chip or chips to take their place. 
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The force required can appear to be quite exceptional, but it 
is necessary. Great care is needed to avoid bending any of 
the legs. 

Very early QLs could not fit their operating system and pro- 
gramming language into the 48K of the two roms and so 
needed a third rom mounted through the rom expansion 
port. It is doubtful that any QL has this configuration today, 
but one useful reminder exists of those times. To relieve the 
demands on limited rom space, Sinclair considered dividing 
the SuperBasic commands into two categories, with com- 
mands only of interest to programmers being loaded from 
microdrive into ram. In preparation for that move, much of 
the SuperBasic language was coded as extensions to the 
QDOS core, which means that it is relatively easy to “unlink” 
parts of the language and replace it with alternative com- 
mands from other sources. 

Roms come in three categories: fixed, programmable and 
re-programmable. True roms are cheap to manufacture from 
a die, but cannot be re-used. Programmable roms begin life 
as a complete set of binary ones and a program is run to 
create the necessary zeroes by, in effect, breaking tracks on 
a matrix. Erasable re-programmable roms (Eproms) are also 
programmed electronically, but prolonged exposure to ultra- 
violet light (for instance, by taking them to a disco) can reset 
the rom ready for a new set of instructions. If there is a bug 
in the contents of either of the first two rom types, the only 
solution is to throw them away and start again. However, 
they are considerably cheaper than Eproms. Incidentally, 
equipment such as electronic music keyboards use a fourth 
category of rom, electronically erasable programmable read 
only memory, or Eeproms. These can be erased by an elec- 
trical charge. Although the value of such chips in the com- 
puter business is easy to see, they are extremely expensive. 

Another disadvantage with all kinds of rom is access 
speed. Random access memory might be volatile, but it is 
very fast A major part of the power of the Miracle Gold Card 
lies in its ability to copy motherboard roms into its own ram 
as part of its start-up sequence. 

Random access memory is also located on the mother- 
board of the QL Its chips are physically smaller than roms, 
but there are many more of them. Memory expansion 
boards containing more ram chips can be added to the QL 
via the 64-way expansion slot. The upper limit of ram is 
decided partly by QDOS and partly by the address bus, 
which is wide enough for a total of 16MB memory. System 
roms, screen maps and QDOS tables occupy part of this fig- 
ure, but even so there is room within the theoretical maxi- 
mum for whole suites of QL programs and their data. More 
realistically, the Gold Card is supplied with 2Mb of ram and 
the brand new Miracle QXL card has a maximum memory 
capacity of 8MB. 


Useful references: 
Sinclair rom family: SQLW Aug 87 page 18, Dec 87 page 
17, Feb 89 page 19 


Minerva rom: SQLW Nov 89 page 26, Sep 90 page 18, 
Dec 90 page 28 
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QL Clones 


Much of the unreliability that made the QL's life so difficult 
at the beginning was due to the physical components. Just 
as the problems with QDOS and SuperBasic were resolved 
by evolving a family of roms, subtle changes appeared in the 
electronics to improve basic reliability. Most QLs were manu- 
factured by Thorn-EMI at Feltham, miles away from where 
the QL was designed and developed in Cambridge. The last 
QLs were manufactured by Samsung of Korea and are gen- 
erally acknowledged to be superior to British-built ones, 
although all late-model QLs are considerably more reliable 
than their predecessors. 

Despite the changes, it takes a keen eye to spot differ- 
ences in the motherboards of Sinclair-sponsored QLs. Far 
more dramatic shifts occurred when QDOS and SuperBasic 
were transported to other computers. This was initially done 
with emulation programs, sometimes backed up with hard- 
ware, running on the Atari ST computer, chosen because its 
CPU belongs to the same family as the QL’s 68008. The 
emulation runs much faster than a real QL 

Other machines were basically a QL in another skin: the 
Thor, the Merlin Tonto sold by British Telecom, and the ICL 
One-Per-Desk. All sold surprisingly well, and were used by a 
wide variety of corporate clients, but did not penetrate the 
home market at all. 

In a way, the Gold Card is a QL emulation running on a 
QL because all the rom is copied into the Gold Card’s own 
memory. The latest hardware transformation is the Miracle 
QXL, an IBM PC expansion card with software to turn its PC 
host into a true QL Standard PCs use an Intel CPU in the 
80x86 series which is quite unsuitable for QDOS. The QXL 
card has its own processor, the Motorola 68EC040. This is 
very much faster than the 68008, but shares the same 
machine code instruction set. 


Useful references: 


Crash-proofing your QL: SQLW Nov 89 page 22 

The Thor: SQLW Jul 86 page 18, Jul 87 page 12 

The ICL One-Per-Desk: SQLW Nov 91 page 24 

Miracle QXL: SQLW Volume II Issue 6 page 8 and 15, 
Volume II Issue 8 page 4 


Yap Ate tional 


Simon Goodwin senses two new TS Services I2C analogue interfaces. 


ony Firshman has gone to a great 

deal of trouble to ensure that his 

new |2C interfaces for the QL are 

programmable from Super-Basic. 
This column demonstrates applications for 
the new Analogue interface, with working 
Super- Basic to play sampled sounds, con- 
vert them from other disk formats, graph 
sampled data and read a proportional ‘ana- 
logue’ joystick in two dimensions. 

Up till now, QL computer signals have 
invariably been digital. This means they are 
considered to be at one of two levels, either 
on or off, true or false. An analogue interface 
allows intermediate values, like shades of 
grey. In this case, a byte of data corresponds 
to a linear scale of 256 voltages, from a pre- 
set minimum to a maximum of a few volts. 
Your programs can generate waves or read 
instruments that return varying signals. 


Analogue Signals 


This is not the place to review the |2C 
hardware; suffice it to say that it's a sturdy 
black box that connects to the Mark 2 
Minerva via two plugs and a ribbon cable. 
You can connect and use several parallel or 
analogue interfaces at once, although the 
software only communicates with one at a 
time. | tested the Analogue version which 
provides four eight-bit inputs per chip, and a 
pair of eight-bit outputs. 

The I2C interface is controlled by a tiny 
machine-code extension, |2C_IO, which calls 
new code in the Minerva rom. The |2C vec- 
tor appears in all the latest Minerva roms, 
but you need the extra chips in the Mark 2 
version (with a real-time clock) to communi- 
cate with other l2C devices. 

I2C_IO lets you use the small amount of 
non-volatile memory in the clock chip, but 
the protocol is complicated and error prone, 
with up to four parameters and an intricate 
message string. The Analogue and Parallel 
I2C interfaces come with extra commands 
that keep 12C_!O at arm’s length. These 
extras are written in SuperBasic by Tony 
Firshman. You can either edit and interpret 
the original source, or use the equivalent 
QLiberated code, also supplied. 

I2C_IO is tersely documented at the back 
of the latest (green) Minerva manual. The l2C 
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[2c Analogue interface demonstrations 
By Simon N Goodwin & Tony Firshman, 1/94 
DEFine PROCedure JOYSTICK 
REMark QL I2C Analogue joystick input 
x=100 : y=100 : OVER -i 
BLOCK 10,10,x,y,2 
REPeat loop 
kS$=READ_adc$(1) 
IF k$=""": BEEP 1000,10 : NEXT loop 
BLOCK 10,10,x,y,2 : Ox=x : oy=y 
x=CODE(k$(1)) : y=CODE(k$(2)) 
BLOCK 10,10,x,y,2 : REMark PRINT #0,x,y 
END REPeat loop 
END DEFine JOYSTICK 


DEFine FuNction READ_adc$(address):LOCal addr%,a$ 
addr%=test_adc_addr%(address):IF addr%<0:RETurn ’’ 
a$=CHR$(160)& CHR$(4)& CHR$(1)& CHRS$(178)& CHRS(3) 
RETurn I2C_IO(a$ & CHR$(156) & CHR$(255),5,addar%,1) 
REMark 160 is send START+device, write from control 
REMark (length 1 is preset), no STOP. First 4 is 
REMark the ADC control to select mode of operation 
REMark 1 will be the first acknowledged byte count 
REMark 178 is send START+device, read 1 acknowledged 
REMark byte to register - ie lose duff old sample. 
REMark 3 will be the acknowledged read byte count 
REMark 156 is read 3 acknowledged bytes to buffer, 
REMark read one more byte to buffer without 

REMark acknowledge, send STOP; 255 is standard finish 
END DEFine READ_adc$ 


REMark non-zero error code on error 

REMark $Sexternal 

DEFine FuNction WRITE_adc%(address,x$) 

LOCal addr%,message$ 
addr%=test_adc_addr%(address):IF addr%<0:RETurn addr% 
message$=CHR$(160) & CHR$(68) & x$ & CHR$(255) 
RETurn I2C_TO(message$,0,addr%,LEN(x$)+1) 

REMark 160 is send START+device, write from control 
REMark buffer (length LEN(x$)+1 is preset) 

REMark 68 is the ADC control byte, x$ is the string 
REMark x$ is the string itself, 255 marks the end. 
END DEFine WRITE_adc% 


DEFine FuNction test_adc_addr%(a) 
RETurn test_addr%(a,72) 
END DEFine test_adc_addr% 


DEFine FuNction test_addr%(a,m%) 

LOCal a% :REMark Simplified by SNG 

IF a<"0" OR a>"127":RETurn -4:REMark Out of range 
IF INT(a)<>a:RETurn -15:REMark Bad parameter 
as=a&&-8:SELect a%=0,m%:RETurn m%||a:REMark OK 
RETurn -7:REMark not found 

END DEFine test_addr% 


DEFine PROCedure REPLAY(files) 

REMark Replays samples up to 32K long from disk 
REMark to DAC channel 1. Uses FLEN, INPUTS ,NEWCHANS 
LOCal k$,e%,ch% : ch%=NEWCHAN% : OPEN_IN #ch%,files 
sampleS=INPUTS(#ch%,FLEN(#ch%)) : CLOSE #ch% 
e%=WRITE_adc$(1,k$) 

END DEFine REPLAY 


interfaces come with a 12 page manual that 
explains the hardware and four new exten- 
sions. READ_PAR and WRITE_PAR transfer 


eight bit signals to or from any parallel port. Listing one. 
WRITE_ADC% and READ_ADC$ move strings of values to or from the 
Analogue/Digital Converters (ADCs). Characters in the string are transferred 
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940 
950 


isting two 
DATA AiKEA 99 
IMPLiICiT% ch 
max=32750 
DIM k$(max),hunk$(20),file$(42),name$(4) 
INK 7 INK #0,7 : PAPER #0,0 
CLS #0 : CSIZE #0,2,0 
REPeat try 
PAPER © =: CLS : CSTZE 2,1 
PAPER 2,0,3 
AT ‘0,2 3 PRINT " Amiga 8SVX IFF sample uA 
AT 1,2 : PRINT " to I2C Analogue converter " 
CSIZE 2,0 
PAPER 2 
AT 5,2 : PRINT "vi.7 © Simon N Goodwin 1994" 
OtRIP 0 > PRINT 


CONVERT_IFF 
END REPeat try 


DEFine PROCedure CONVERT _IFF 
LOCal ch,in%,size 
REMark Converts signed 8SVX byte IFF samples 
REMark to I2C unsigned format; uses INPUTS & ANYOPEN% 
REPeat loop 
INPUT #0;"Enter IFF drive and file name:"\files 
IF file$="": PRINT #0;"STOPPED" : STOP 
in%=ANYOPEN%(file$,1) 
IF in%>=0 : EXIT loop 
PRINT #0;"Error " .& yin 
END REPeat loop 
HUNK name$,size 
IF INPUTS( #in%,4)="8SVX" 
REPeat scan 
HUNK name$,size 
IF name$="BODY" 
CONVERT size : 
ELSE 
REMark Skip this hunk 
hunk$=INPUTS(#in%,size+(size MOD 2)) 
REMark Skip nulls 
FOR ch=LEN(hunk$) TO 2 STEP -1 
If hunk$(ch)=CHR$(0):hunk$=hunk$(1 TO ch-1) 
END FOR ch 
IF LEN(hunk$)>1 
INK 4 : PRINT 
INK 7 
END IF 
IF EOF(#in%) 
PRINT #0;"No sample body found."’ 
END IF 
END IF 
END REPeat scan 
ELSE 
PRINT #0;"Sample is not in IFF 8SVX format." 
END IF ' 
CLOSE #in% 
END DEFine CONVERT_IFF 


& ", please try again." 


EXIT scan 


pee & hunks &i 7 ws 


: EXIT scan 


REFERENCE kS$,k 

DEFine PROCedure HUNK(k$,k) 

KS=INPUTS(#in%,4) 

PRINT "Hunk name = " & kS; 

k=0 : FOR ch=1 TO 4:k=k*256+CODE(INKEYS(#in%,-1)) 
PRINT " Hunk size =" &k 

END DEFine HUNK 


DEFine PROCedure CONVERT(bytes ) 

REMark Signed bytes to unsignéd, one by one! 

LOCal ch,k%,out% 

IF bytes>max 
PRINT \"File too long - truncating to " & max 
bytes=max 

END IF 

kKS$=INPUTS(#in%,bytes) 

PRINT \"Converting sample ... "; 

REMark OPEN #5,scr_512x256a0x0 

FOR ch=1 TO bytes 
k%=CODE(k$(ch) ) 
IF k%>127 : kS=k%-128 : ELSE k%=k%+128 
REMark PLOT #5,1% && 511,k% 
k$(ch)=CHR$(k% ) 

END FOR ch 

REMark CLOSE #5 

PRINT "OK" 

INPUT #0;"Enter output drive and file name:"\file$ 

out%=ANYOPENS (file$,2) 

IF out%>=0 
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one by one over the I2C interface, at a rate of 
around 10,000 eight-bit bytes per second. 

Simplified source for WRITE_ADC% and READ 
_ADC$ appears in the first listing.The originals used 
clever SuperBasic to check parameters, but I've 
replaced this with simpler stuff to catch most cases. 

The function TEST ADDR% checks that an l2C 
port address is valid, using interesting bitwise oper 
ations. The extensions are carefully designed to 
detect mistakes before they reach the I2C ports, 
and retum meaningful error-codes. 

The |2C address contains two parts in one byte. 
The bottom three bits are the unit number, while the 
other bits identify the tyoe. Thus you can have up to 
eight interfaces of each type. When you call 
READ_ADCS$ or WRITE_ADC% you can pass the 
full eight-bit address or a simple unit number 0 to 7, 
in which case the code sets the other bits to suit 
the type. The ‘bitwise or operator II [two vertical bars] 
combines the type, M%, with the address in A 
a%=a&&-8 retums zero if a is less than 8; otherwise 
it sets A% to the value of A with the bottom three 
bits cleared. 

The value -8 corresponds to 11111000 in eight 
bit binary. The SELect on A% ensures that the 
type must either be zero or match M%, which is 
78 for Analogue (ADC) ports or 56 for PAR ones. 

| put the range check values in quotes on 
line 630, so errors are unlikely even if parame- 
ter A is passed as a string, rather than a num- 
ber. The quotes ensure that the parameter is 
coerced into a string before the comparison 
takes place. For yet more reliability, use 
UNSET from DIY Toolkit Volume P to ensure 
that the parameter has a value. 


Demonstrations 


The JOYSTICK procedure contains a small 
loop that lets you move a block cursor around 
the screen with an analogue joystick. The cur- 
sor is drawn in OVER -1, so that it comple- 
ments the background colour and vanishes 
when drawn a second time. Tyoe OVER 0 to 
cancel this if subsequent PRINT commands 
give messy results. 

The demonstration runs as a loop, reading 
the inputs on port one and converting the 
resultant characters into co-ordinates for 
BLOCK. Remove the REMark from the middle 
of line 220 if you want co-ordinates displayed 
in window #0 as the block-moves. There’s little 
risk of an ‘out of range’ error as new Minerva 
roms clip BLOCKs to fit any window. 

| made up a simple lead to connect the two 
potentiometers of a £5 Amstrad PC joystick to 
a pair of 12C analogue inputs. This could 
replace a mouse, as long as eight bit (MODE 
8 pixel) resolution is good enough for your 
purposes. The advantage is that results are 
repeatable. Any particular position of the stick 
will correspond to a position on the screen. 

As you move the stick the cursor jumps 
directly from place to place, in proportion to 
the movement. This is far more precise than a 
switched digital joystick, like the sort that plugs 
into QL Ctrl ports, which can only signal ‘up’, 
‘down, ‘left’ or ‘right’, with no indication of pro- 
portion or speed. 

Depending on your graphics routines you 
reverse the Y co-ordinate and scale the results from 


PRINT "Saving " & fileS & " ... 
PRINT #out%,kS; 
CLOSE #out% 
PRINT "OK" 
ELSE 
PRINT #0;"Error " & out? & ", 


file not saved 
20 END IF 
PAUSE 75 
640 END DEFine CONVERT 


5G DEFine PROCedure S 
070 SAVE FLP1_1IlFF_TO_12C_BAS 
i080 END DEFine S 
READ_ADCS up or down. Most sticks have knobs that limnitf travel. 
Often joysticks use a small part of the possible potentiomenter 
movement, so they do not retum the whole voltage range. If you 
need maximum precision, with values from 0 to 255 rather than 
(say) 80 to 160, you might need three resistors or a couple of pre- 
sets to set appropriate limits for the interface. If these are set too 
close together the stick will only make a difference for part of its trav- 
el, and will stick at O or 255 before it reaches the end-stop. 


More Precise 


PROCedure REPLAY uses the function WRITE_ADC% to play a 
sampled sound. The graph shows the wave - a sampled recording 
of ‘Rimmer from the BBC space-ship ‘Red Dwarf saying 
‘Marvellous’ with characteristic enthusiasm. NEWCHAN% is from 
DIY Toolkit Volume R. It retums a free channel number. 

The 32K string length limit means that each utterance is limited 
in length to about 3 seconds, but you can fire them out in rapid 
succession. There's a short pause as SuperBasic hefts each new 
string into place, but you could create near-continuous speech by 
assembling and replaying ‘phoneme’ strings. 

The sample rate is better than telephone specification but 
worse than AM radio. Speech is clear enough, while music 
sounds recognisable but a little distorted. It is important to 
use the full eight-bit range when recording samples, without 
overloading. To check this, display the sample as a graph. 

The graph uses two dots (sample levels) in each column, 
which means each width of the mode4 screen comesponds 
to about one tenth of a second, at the fixed I2C rate of 10K per sec- 
ondSamples might not be recorded at this rate - possibilities range 
from around 2,000 per second for toys to 44,100 for CDs - so they 
may sound slow or fast when replayed via I2C. Once the wave is in 
digital form you can change the length and pitch by interpolating 
extra values to slow down a fast sample, or averaging them in a 
sample that plays too slomy. 

The two traces follow the ‘WM’ sound at the beginning of the word. 
The middle trace was drawn first The level is limited by the louder 
‘an’ sound that comes later. The whole sample uses 
about 17K 


The colour must be specified each time; move the IF test 
on line 230 to 295 if you want the same colours with 
BLOCK as PLOT. 

Eight-bit samples are widely available from PD libraries; 
the ‘Rimmer sample came from an Amiga cover-disk. 
- |Sample formats vary; some are signed values from -128 
to 127, others (like the I2C ones) are unsigned bytes, and 
most are packed or padded in some way. 


Decoders 


QL users have easy access to these files via the PD 
Amiga Qdos QL_HANDLER, DiscOver and similar utilities, so 
Ive written programs to decode Amiga IFF (Interchange File 
Format) ‘8SVX’ and some Microsoft .WAV files. Many utilities 
on Mac, PC and other computers support these formats. 

The second listing is my IFF file Converter, written in 
SuperBasic. You need the IFF file on a QL drive first; the pro- 
gram converts that sample into the 12C format used by 
REPLAY and WRITE_ADC%. 

The Turbo/DIYT extension INPUTS is used in REPLAY and 
the IFF Converter to read a sequence of characters from a 
file in one go. If you lack INPUTS and are in no hury you 
could build a string with successive calls to INKEYS. FLEN is 
in Toolkit 2, PD Toolkit, Thors and most disk roms. 

IFF files consist of a sequence of ‘hunks’ with four 
character names and 32 bit sizes at the start of each. 
CONVERT_IFF looks for the 8SVX block that contains the sample, 
skipping or reporting others en route. IFF supports graphics, text 
and animations as well as sounds; Ergon’s Open World utility con- 
verts IFF graphics to QL modes. 

PROCedure CONVERT changes each byte from signed to 
unsigned format This conversion is accelerated amazingly much 
by Turbo, which is why Ive supplied TF Services with a compiled 
version for I2C users. The initial DATA-AREA and IMPLICIT% direc- 
tives instruct the Turbo compiler. Remove the REMs on lines 840, 
880 and 910 to see a rough graph as the sample is converted, 

There's lots more to be done with the Analogue interface and a 
litle SuperBasic. You could keep tabs on your your environment 
with temperature and light sensors, ranging from old-fashioned 
thermistors and light-dependent resistors to the latest active sen- 
sors. You could control a robot, record speech messages for digital 
replay, in a QL-controlled answerphone, or synthesise waves of 
sound or pattems of light with simple formulae. 

Alas, |2C is not for everyone. You need the Mark 2 Minerva, and a 

litle knowledge of electricity, to make use of any I2C interface. The 

programming is simple and exciting, because these ports let 
your QL interact with the intricate world outside, where a little 
SuperBasic can go a long way. Listing three. 


PROCedure GRAPH plots the wave. The PUT #3\0 
in line 150 is only needed if you want to re-plot without 
re-opening the file. Lines 170 and 180 use BLOCK eff- 
ciently to plot a fine millisecond grid. Change the limit 
of the FOR T loop if you want more of the sample over- 
laid on each screen. Lines 220 and 230 ensure that 
each trace appears in a new colour, starting with green, 
then white, then red, and back to green. Pixels are lit by 
the DIY Toolkit PLOT function, from graphics Volume G. 
If you dont mind a slower, flickering display you could 
replace PLOT with a call to BLOCK like this: 

270 BLOCK #4,1,1,j, CODE(kS(i)),colour 

Sinclairs BLOCK routine is clumsy if you're try- 
ing to light individual pixels, but at least it's not as 
eccentric as POINT. In QL Mode and Thor 
Mode12 you need to change the width (second 
parameter) to 2 or the dot will not appear. 

Flicker appears because each BLOCK is drawn 
as a short line and clipped on either side to fit. 


DEFine PROCedure GRAPH 
REMark Uses INPUTS and PLOT (DIY Toolkit) 
REMark + PUT and FLEN (PD/SuperToolkit) 
MODE 4 : red=2 : green=4 
OPEN_IN #3,"flpl_marvelous_QL" 
PUT #3\0 
OPEN #4,"scr_512x256a0x0" 
FOR y=8 TO 255 STEP 10 : BLOCK #4,512,1,0,y,red,0 
FOR x=6 TO 511 STEP 10 : BLOCK #4,1,256,x,0,red,0 
colour=red 
FOR t=1 TO 2 
REMark For more scans use T=1 TO FLEN(#3) DIV 1024 
colour=colour+red : INK #4,colour 
IF colour>green : colour=0 
kS=INPUTS (#3 ,1024) 
FOR i=1 TO 1023 STEP 2 
j=i DIV 2 
PLOT #4,3,CODE(k$(i)) 
PLOT #4,3,CODE(k$(i+1) ) 
END FOR i 
END FOR t 
CLOSE #4 
CLOSE #3 
END DEFine GRAPH 
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HIGH SPEED 


PROCESSOR 


DD, HD, ED, 
DISK 
INTERFACE 


QL GOLD CARD 


£225 inc. (£200 outside EC) 


This is the expansion that has been revolutionising the QL. It is very easy to fit - 
it simply plugs into the expansion port at the left hand of the QL - and once fitted 
it will instantly increase the execution speed of the QL by about 4 times due to 
the presence of a 16MHz 68000 on board. There is 2M of fast 16 bit RAM of 
which QDOS sees a contiguous 1920K. The remainder is used for shadowing 
the QL’s ROM and display memory and for the GOLD CARD's own code. 


There is a disk interface which can access 3 mechanisms (4 with the DISK 
ADAPTER) of 3 different densities, DD (double density, 720K), HD (high density, 
1.44M) and ED (extra high density, 3.2M) in any mix. The disk interface 
connector is the same type that was fitted to the TRUMP CARD so most QL 
compatible disk drives can be used. Please note that DD drives still give a 
capacity of 720K per diskette. Our DUAL ED DISK DRIVE allows the GOLD 
CARD to access DD, HD and ED diskettes. 


Another feature is the battery backed clock. When the QL is switched on the 
contents of the clock are copied into the QL’s clock so that the time and date are 
correct. The firmware in the ROM gives the GOLD CARD all the functionality of 
the TRUMP CARD like TOOLKIT I! and there is a sub-directory system for 
floppy and RAM disks. 


Physically the GOLD CARD is about half the size of the TRUMP CARD and so 

fits almost all within the QL. Its current consumption is well under the allowable 

maximum so no special power supply is required, The GOLD CARD comes with 
a 14 day money back guarantee and a 2 year warranty. 


BATTERY 
BACKED 


CUSTOM 
LOGIC 
CHIP 


CLOCK 


Tel: (0904) 423986 


To place an order by phone 
please have your credit card 
ready. For overseas customers 
we charge the prices shown in 
brackets. 


See the QXL and GOLD CARD at: 


Saturday 12 Febraury 1994 
Scottish Workshop 
Craiglockhart Campus 
Napier University 
Colinton Road 
EDINBURGH 


Saturday 19 Febraury 1994 
INTERNATIONAL QL MEETING 
Bielefeld 
GERMANY 


Please send me 


15 Kilburn Court, Newport, RI 02840, U.S.A. direct. 


' teralpeteeslaee loeslelel elon leet oe toetae eaten lantontententantentertentententertetet ttt tte ee 


MIRACLE SYSTEMS 


16MHZ 68000 


The QXL turns the common PC into a QL compatible. The package comprises a half 
card that plugs into an 8 or 16 bit standard ISA slot and a diskette loaded with a QDOS 
compatible operating system and a Superbasic compatible interpreter. After installation 

simply type QXL and the PC will appear to be a QL allowing QL programs to be run from 
QL format diskettes. 


The card itself has a 32 bit 68EC040 processor running at 20MHz which gives a good 
turn of speed. This processor has access to its own RAM and so performance is virtually 
independent of the host PC whether it has an 8088 or a Pentium. In fact the PC is used 
purely as an I/O system giving QL programs access to the PC's floppy disc, hard disc, 
keyboard, display, serial and parallel ports. The card itself has QL style network ports to 
allow connection to a QL network. The minimum PC specification required is an XT with 
EGA display and a spare standard slot. 


Varying RAM sizes from 1M up to 8M can be supplied. The smaller capacities can be 
upgraded to the larger ones and the cost is simply the price difference. Not all the RAM 
is available to the user programs; the 1M equates roughly with a TRUMP CARD QL 
memory size and the 2M with a GOLD CARD QL. 


During the lifetime of the QXL we intend to enhance the software to make use of the new 
hardware facilities of the PC such as SVGA graphics. As has been our policy with the 
TRUMP CARD and GOLD CARD we intend to provide software upgrades free of charge. 


QXL prices 


IM £295 (£255) 
2M £325 (£280) 
SM £410 (£355) 
8M £495 (£430) 


(prices in brackets for outside EC) 


INTERNATIONAL QL REPORT (IQLR) is a regular magazine that all QL 
users should read. It has articles for the beginner, the advanced user and 
every one else in between. Also, the international flavour combined with 
low advertising rates makes it probably the best place to locate QL related 
items. IQLR is run by QL enthusiasts whose proud boast is that they have 
never been late with an issue. If you do not already get it then ‘phone us 
now. One year’s subscription for 6 issues to any European address is 


£22.00 and it’s worth every penny. Subscribers 
elsewhere should contact SeaCoast Services, 


To: MIRACLE SYSTEMS Ltd, 25 Broughton Way, 


Osbaldwick, York, YO1 3BG, U.K. Tel: (0904) 423986 


| enclose a cheque to the value of: £ 


Signature 


To order by post, please fill in | Or debit credit card 

the form opposite or write to / 
us quoting your credit card pat 
number and expiry date, or 

enclosing a cheque payable to 1 Name 

MIRACLE SYSTEMS Ltd. Riédress 


Miracle Plan to Take On Software Too 


After a delay since last November, while a number of small bugs were sorted 
out, Miracle Systems have made a lot of progress with software for their PC- 
colonising QL card QXL, and are hoping to have a new release for users by the 
time this news item is published. 

Said Stuart Honeyball: “The disk formatting software should be fixed and the 
compatibility of the 8-bit slot have been sorted out. We have had one release from 
Tony (Tebby, QL operating system author) in the meantime which we didn't issue 
because there were a few things that needed some more work. They were mostly 
fairly minor.” The SuperBasic is also expected to be ready before too long, but 
there is no date yet. 

Stuart sees Miracle moving more and more into producing their own software 
as time goes on. “We need to move the QL into multi-processing’, says Stuart, 
laughing, “l have seen the future of the QL and it is multiprocessing!” Make no 
doubt about it, he’s in earnest. 

In the meanwhile, Miracle are also working on a new version of the Gold Card. 
True to their regular policy, Stuart did not want to say more about that until he can 
give a clear schedule for it, and asked us to ask him again in two or three weeks. 
Rumour, though, is whispering that the new version will be even faster than the 
present one. 

Miracle’s show calendar after February includes the ever-popular Quanta Bristol! 
Workshop on 27th March (contact Quanta), the Quanta AGM on 23/24th April in 
Tynemouth, Northumberland, and another visit to Newport, Rhode Island, USA, for 
May 14th, where they hope to show the first version of their SCSI card. Miracle 
have a full diary for January and February, including Edinburgh on 12th and 
Bielefeld on 19th (See QL Scene). They came back from Manchester/Blackrod 
disappointed by attendance - “not enough publicity’, said Stuart, and QL World 


can only agree. 


NEW PUBLIC DOMAIN COMMS 


SJPD Software have now added to their disk collection C68 Compiler V4.01 from Dave 
Walker, plus two new communications packages from Jonathan Hudson: QeM Release 
4.00 and QTPI (Disks SUS 44 and 77). QeM 4.00 offers full ANSI colour graphics mode, 
VT52 and VT100 terminal emulation, and it also supports Tandata’s QConnect and Hayes 
Compatible Modems, along with a host of other features. QTPI runs under the Pointer 
Environment for those who already have the Pointer Environment, and offers all the fea- 
tures of QeM, plus others. 

Also new to the collection is QLfax and ATP Offline Reader (SUS 74), both in the Beta 
Test versions at the time of writing. Steve warns: “They are in their infancy, but have 
reached a stage where they are almost stable (| hope!).” Also new is the demo version of 
LineDesign, which is also a Pointer Environment program, and has all the features of the 
general release of LineDesign, except, of course, that you cannot save and print with it 

In the SUPD list, there is now Zip and Unzip 3.0 (file compressor, QSpread Demo 
(Pointer Environment spreadsheet demo), Archive to Pipedream Conversion Program (for 
Cambridge Z88 users), Deskjet Envelope Printer (for Deskjet 500) and Indexer Demo. 

Steve’s well-known literary collection now also features works by Jane Austen, Bram 
“Dracula” Stoker, Mary “Frankenstein” Shelley, Emily Bronte, Cervantes, Charles Darwin 
and Chaucer. Who says computer buffs don’t read? 

All disks are £1.75 inclusive of media and return postage, or £1 if user supplies disk 
and return postage. 

SJPD also supplies second-user QL hardware and software, and back issues of QL 
magazines. 

In particular Demo versions of commercial software are a very good deal if you want to 
check them out before deciding if they might add to your QL life. Steve's disk-catalogue is 
continually updated and contains some PD software too. It is free to anyone who sends a 
disk, return postage and a self-addressed label. Program versions are continually updat- 


ed. 
SJPD are at 36 Eldwick St. Burnley, Lancs BB10 3DZ. Tel. 0282 451854. 


Famous Meters 
Hit 70 Years 


Electronics and electrical 
experts will be pleased to hear 
that the well-known Avometer, 
the original multimeter, has just 
celebrated its 70th birthday. 
That's older than many of us. 
The “big black box” has been 
around since 1923, and is still 
going strong. 

How many computers do 
you think will be able to say 
that in the year 2050? 

If you think that you can per- 
suade the family to buy you a 
new one for Christmas (or even 
next Christmas), ask for infor- 
mation from Avo International, 
Archcliffe Road, Dover, Kent 
CT17 9EN, UK. Tel. 0304 
202620. 


Jochen Merz has told us 
that the Pointer Envir- 
onment is indeed sup- 
plied with their new multi- 
tasking chess program 
Black Knight. 
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In part 8, Alan Bridewell sets the code to trace and manipulate pixels. 


t the start of this series | said 

that | would illustrate all the 

ideas with routines that 

would produce something 
on the screen. Initially, this only need- 
ed a knowledge of the addresses of 
the screen ram, without any under- 
standing of how it was organised. 
Later, it was necessary to realise that 
the screen ram was organised in 
words (pairs of adjacent bytes) which 
held the data for a set of four or eight 
consecutive pixels, depending on 
whether the QL is in mode8 or 
mode4. 

There is normally no need to 
understand more than this because 
the complicated job of drawing lines 
or printing text on the screen is done 
by Qdos routines, which we can use 
in Our programs without having to 
know what they are or how they actu- 
ally work. 


Pixel Printing 


However, there is one type of prob- 
lem where the programmer really 
needs to know exactly how the infor- 
mation for the colour of each pixel is 
stored. (This is true regardless of the 
language being used, including 
SuperBasic) 

There are programs where the pro- 
grammer needs to find the colours 
of individual pixels on the screen. 
The classic example is the screen 
dump routine for a printer. For a 
colour printer, the program must first 
identify the pixel colour, before send- 
ing data to the printer to print a dot of 
that colour. For a monochrome print- 
er the program must send data for a 
pattern of dots to produce a suitable 
grey tone for each colour. | am not 
really concerned here with what the 
program does with the data, so 
much as how it gets that data in the 
first place. 

| am not going to use this to pro- 
duce a screen dump routine. Firstly,’ | 
said | would make the program do 
something ON the screen. Secondly, 
different printers require different data, 
and anyway, not everyone has a 
printer. However, if you do have a 


5 EERE HEHEHE EEK ERK EEE EH EERE NE HEE HK KKH KEKE EKER RHHHEEH KES KHKKKER HERE RK 


5 


- OPEN 


3 


GPEN A CON CHANNEL 
RHR EH EE EHR EK EE HIKE HEE KE KEE EH KEKE EEE REI KKK IKI EE EE 


CON,AL 3 CON TABLE POINTER IN Si 
$C6,A2 3 UT_CON VECTOR IN 42 
(A2) 3 OPEN CONSOLE CHANNEL 
ID,AL 3 CHANNEL ID STORE IN #1 
AO, (AL) s STORE CHANNEL ID 


RI EH EE EER KERR EHH HEHEHE EEE EE MERE KE HERE EERE REE ERE RE LR EK 
WRITE TEXT IN CON WINDOW 


BE IE EH HHH EH EK HEH HEHEHE EE ERE HEE EK E EE HEE EK EEE EHE HE EER HERE KE 


3 
»~PTEXT 


5 


3 


LEA.L ID,Ai 3 CHANNEL ID STORE IN Ali 
MOVES. (Ai) ,AO 3 CHANNEL ID IN AG 
LEA.L TEXT.AL 3; BASE OF TEXT IN A? 
MOVEA.W $D0,A2 3 UT_MTEXT VECTOR IN AZ 
JSR (A2) 5 PRINT TEXT 


HH EH IKK EEK EEE HEHEHE EHH HEE EEE EHH HEHEHE EHH HEEL KEELER EEE IERIE 
FETCH A LINE OF CHARACTERS 


BREE EHH EK EEE KEKE KE EK RERE EEE EE EEE EEK ERE EER EEE REE EEE EEE EKER EERE EERE BER 


«FETCH 


3 fHIS LEAVES THE LENGTH OF THE STRING (INCLUDING THE LF) 


5 THE STRING (WITHOUT THE LF) JUST BEFORE THE STRING ITSELF 
; STORED IN THE SUFFER). 


LEA.L 
MOVEA.L 
LEA.L 


ID,Ai 3 CHANNEL ID STORE IN Ai 
(A1),AO 3 CHANNEL ID IN AO 

BUFFER,A1 ; BUFFER ADDRESS IN 41 

MOVEQ #2,D0 3 #IO_FLINE IN DO 

MOVE. W #BUFLEN,D2 ; BUFFER LENGTH IN D2 

MOVEQ #-1,D3 3 INFINITE TIMEOUT 

TRAP #3 

IN Di. 

IF WE WANT TG USE THIS STRING AS A CHANNEL NAME, WE NEED THE LENGTH OF 
(WHICH TS NOW 


SsO:— 


3 SUBTRACT 1 FROM THE STRING LENGTH.... 


SUBG.L #1,D1 3; SUBTRACT 1 FROM Di 
«++.AND PUT THE RESULT IN BUFPOS, JUST IN FRONT OF BUFFER 
LEA.L BUFPOS,AO ; LOAD BUFPOS IN AO 


MOVE .W Di, (Ad) 5 PUT CONTENTS GF Di IN BUFPOS 


fF EERE EE KIRA EEER EKER EH EEE EEK EE EEE KEE KE KEER ER EE EERE EE EE ERNE EN EEE 


OPEN THE FILE 


fp ERE E LE KH EE HK EEE EE KEKE KK ERE KEKE EK EEE EEE EE KKHE HERE RENEE HRER 


LEA.L 
MOVEQ 
MGVEQ 
MOVEG 
TRAP 
TSTLE s IS THERE AN ERROR? 
BEG.S GOT_FILE ; IF NOT, CONTINUE... 


BUFPOS,AO ; BUFPOS IN AO 

3; OPEN AND OLD, SHARED FILE 
; -1 IN Di MEANS ‘THiS JOS 
; #I10_OPEN IN Do 


MOVEA.W $CA,AZ 3 ERRO IN A2 
JSR (AZ) = 3 PRINT ERROR MESSAGE iN #0 
JMP PTEXT 3 REPEAT PROMPT 


: STGRE FILE CHANNEL I.D WHICH IS NOW IN AO 


3 
~GOT_FILE 


LEA.L 
MOVEA.L 


FILE,AL 
AO, (AL) 


3 ADDRESS OF FILE IN Al 
3; CONTENTS OF AO INTG ADDRESS IN AL 


3 
3: NOW LOAD THE FILE INTO THE SCREEN RAM 


MOVE.L 
MOVEA.L 
MOVER 


#$8000,D2 ; FILE LENGTH IN D2 
#$20000,A1  ; LOAD ADDRESS IN Ai 
#-1,D3 : INFINITE TIMEOUT 
MOVEA.-L FILE,AG 3 FILE CHANNEL I.F IN AO 
MOVEQ #$48,D0  ; FS_LOAD IN DO 

TRAP #3 
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printer, and if you understand this article, 
and understand your printer manual, you 
should be able to have a go at produc- 
ing a screen dump routine of your own. 


Screen Ram 


So how exactly is the QL screen ram 
organised? 

Each row of pixels on the screen 
requires 128 consecutive bytes (64 con- 
secutive words) to store the data. This is 
true regardless of whether we are using 
mode4 or mode®. In mode4, each word 
holds the data for eight consecutive pix- 
els, making 512 pixels in a row. In mode 
eight, each word holds the data for only 
four consecutive pixels, making 256 pix- 
els in a row. Since each mode8 pixel is 
twice as wide as a mode4 pixel, 512 
mode4 pixels and 256 mode® pixels 
occupy the same width of screen. 

The difference in the number of pixels 
that each word can hold arises asl will 
describe. 

In mode4, there are only four states 
each pixel can be: black, red, green or 
white. Data involving four possible val- 
ues can be held by two bits (binary dig- 
its), because they can have four combi- 
nations, 00, 01, 10 and 11. Now in a 
word (two bytes) there are eight pairs of 
bits, so. a word can hold the data for 
eight pixels. 

In mode8, there are sixteen states 
each pixel can be: one of eight colours 
in two possible states, flashing or not 
flashing, making sixteen states in all. | 
will leave you to work out that sixteen 
possible values requires four bits, and 
as a word contains four lots of four bits, 
it can only hold data for four pixels. The 
entire screen contains 256 rows of pix- 
els in either mode, so requires 256 times 
128 bytes of ram, which comes to 
32768 bytes, 


Odds and Evens 


Each word in the ram consists of an 
even address and the following odd 
address. The total number held by the 
word is worked out from the numbers in 
the two bytes as follows. The number in 
the even bytes is multiplied by 256 and 
added to the number in the odd byte. 
This sounds complicated until you see 
how it works out in binary numbers. Also, 
since it is the individual bits which carry 
the data, it is much clearer why a partic- 
ular value has the effect it has iwnen we 
use binary numbers. 

256 in decimal is 100000000 in binary, 
and you multiply a binary number by 
100000000 by adding eight zeroes. For 
example, if the even bytes holds 
11110000 and the odd byte holds 
1010101010, the word will hold 
1111000010101010 because: 


(11110000 x 100000000) + 10101010 = 


ZF EEK EK HEHEHE HEE KEE KEE KEKE EEE EK EEE KEKE KE HEHE EEE EEE EEE EEE REEL ER ERE REESE 


CONVERT SCREEN TO MONOCHROME : 
FI IER EEE EE EEE RHEE IEEE IERIE HEHE AIHA EH IIIS IERIE SRE EB EME. 


MOVEA.L 
MOVE.W 
MOVE. W 
MOVE .W 
MOVEQ 
MOVE .W 
MOVE. WwW 
AND.W 
BEG 
CMP.W 
BEQ 
MOVE.W 
AND..W 
CMPI.W 


#$FF,D5 
#$3F ,D6 
(Al) ,D1 
#$7 ,D2 


- ROWLOOP 
- WORDLOGP 


. BITLOOP D3,D4 
D1,D4 
BLACK 
D3,D4 
WHITE 
D3,D4 
D1,D4 
#FF ,D4 
RED 
GREEN 
#1,D3 


D2,BITLOOP ; 


#2,A1 


#$8080 ,D3 


##20000,A1 3; ADDRESS IN Ai 


3 ROW COUNTER 
3 WORD COUNTER (iN ROW) 
3 CONTENTS INTO D1 
3; 8 BITS IN BYTE 
TEST BITS 
3 COPY TEST BITS 
3 COMPARE WITH Di 
IF ZERG, THEN BLACK 
3 IS IT THE SAME AS TEST BiTS? 
3 IF SO, THEN WHITE 
3 RECOPY TEST BITS 
3 COMPARE WITH Di 
3; WHICH BIT IS SET? 
; IF LSB BIT THEN RED 
5 ELSE GREEN 
3 NEXT BITS 
AND LOOP 
3 INCREMENT TO NEXT WORD 


Dé6,WORDLOOP ; NEXT SCREEN WORD 


YORIGIN, 


#1, (AS) 


XORIGIN, 


#0, (A3) 


AS 

3 INCREMENT YORIGIN 
AS 

3 RESET XORIGIN 


DS,ROWLOOP ; NEXT ROW 


XORIGIN, 


#0, (AS) 


YOGRIGIN, 


#0, (A3) 


AS 

3 RESET XORIGIN 
AS 

3 RESET YORIGIN 


5 KR HEHEHE HEHE KEKE EEE EEE EEE KEE IEEE EEE EEK ERE EEE HEHEHE EE ER EEE EEE KEE HERES 


3 CLOSE THE CHANNELS 
SEHK EE EEE EE KEK HEHEHE EEK KEENE KEKE EER EE HERE EEK EEE ERIE ER 


LEA.L 
MOVEA.L 
MOVEQ 
TRAP 
LEA.L 
MOVEA.L 
MOVEQ 
TRAP 
RTS 


FILE,A1 
(A1) ,A0 
#2,D0 
#2 
ID,A1L 
(A1) ,AO 
#2,D0 
#2 


3 ADDRESS OF FILE CHANNEL 1[.D. 

3 INTO AO 

3 IO_CLOSE IN DO 

3 CLOSE FILE 

3 ADDRESS OF CONSOLE CHANNEL I.D. 
3 INTO AO 

3 IO_CLOSE IN DO 

3 CLOSE CONSOLE 

3 RETURN TO SUPERBASIC 


FEE EAH KE LRH KEKE KKK HEE ELH EEL HEEL LE EERE EEK KEKE ER EEE REE ERLE EEN EERE REE 
3 PRINT BLOCK SuBRUU/ {NE 
EEE EAH KH HEE EEK EE HERE HEE EEE EEE KEKE EHH EE KEKE KE EEE ENE BRE EEK ENE 


. BLACK. 


MOVEM.L 
MOVEW 
BRA 


#0,D1 
DRAW 
. GREEN MOVEM.L 
MOVE. B 
BRA 


#4,D1 
DRAW 


MOVEM.L 
MOVE.B 
BRA 


#224,D1 
DRAW 


1111000000000000 + 10101010 = 
1111000010101010 


In other words, we get the entire 
number by simply putting the two 
numbers together, even before odd. 

How are the colours represented by 
this? Let us look at modeé first. 

The even byte gives the greens and 
the odd byte gives the reds. Each bit 
read from left to right gives the row of 8 
pixels, again, from left to right. A 1 
means the colour is set, and a 0 
means it is cleared. If both are set we 
get white. If neither are set we get 
black. It is clearer what is going on if 
we put the bytes one under the other, 
so the two bits affecting the same pixel 
are together. So in the example above 
we get: 


AO-A7/DO-D7,-(A7) 3: 


AO-B87/DO—-D7 ,—-(A7) 5 


A0-A7/DO-D7 ,-(A7) 3 SAVE REGISTERS 


3 BLACK 


SAVE REGISTERS 
3 GREEN 


SAVE REGISTERS 
3 RED 


EVEN (GREEN) 11110000 
ODD (RED) 10101010 


The first pair of bits are both set, so 
we get white. In the next pair, only the 
even bit is set, so we get green. 
Following across all the bits we can 
see that this word will give a row of 
pixels: 


WHITE, GREEN, WHITE, GREEN, RED, 
BLACK, RED, BLACK. 


Mode8 is more complicated. The 
even byte gives greens and flashings 
with pairs of adjacent bits. The odd 
byte gives reds and blues with pairs of 
adjacent bits. So taking the same 
example again: 
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MOVEM.L 
MOVE.B #212,D1 
LEA.L 
MOVE.L 
LEA.L 
MOVE® 
MOVE® 
TRAP 
LEA.L 
ADD.W 
MOVEM.L 
BRA 


#1, (AS) 


RET 


&0-A7/DO-D7 ,—-(A7) 


3 SAVE REGISTERS 
3 WHITE 


3 CHANNEL iD IN AG 
3 BLOCK BASE IN Al 


3 SD_FILL IN DO 
3 INFINITE TIMEOUT 


XORIGIN,AS 


3 INCREMENT XORIGIN 


{A7)+,A0-A7/DO-D7 3; RESTORE REGISTERS 


3 RETURN TO MAIN ROUTINE 


; HEE EEK HEHEHE KH EI EIEN SAHNI AKA INES EAR ENE IK 
: PARAMETERS, DATA AND DATA SPACES 


: 
SEEK EK KEE EER EEE EEE EK E EEE EE EER EEE KER EERERER EHEEKEEH EKER ERE KEE KER ERE 


; SPACE RESERVED FOR CONSOLE CHANNEL PARAMETERS 


. CON $0000 
$0007 
#0200 
$0100" 
$0000 
$0090 


3 BORDER COLOUR & WIDTH 
3 PAPER & INK COLOUR 

3 WIDTH 

3 HEIGHT 

; X ORIGIN 

3 Y ORIGIN 


: SPACE RESERVED FOR CONSOLE CHANNEL I.D. 


-ID DC.L 


: SPACE RESRVED FOR BLOCK DEFINITION 


- BLOCK DC.W 
DC.W 
DC.W 
Dc.wW 


- XORIGIN 
- YORIGIN 


3 

3 SPACE RESERVED FOR FILE CHANNEL I.D. 
3 

»FILE DC.L 
3 TEXT TO BE WRITTEN IN THE WINDOW 


3 
« TEXT $0C 


“FILE NAME 7? ™ 


. BUFLEN 
; 
. BUFFOS 


. BUFFER 


$00000000' ; 


$00000000 3; 


CONSOLE CHANNEL ID 


s 1 PIXEL WIDE 

3 1 PIXELS HIGH 

3; X ORIGIN OF BLOCK 
3 Y ORIGIN OF BLOCK 


FILE CHANNEL i.D. 


3 NUMBER OF CHARACTERS 
3 CHARACTERS 


s LENGTH OF INPUT BUFFER 


3 
FERRE EERE EEE EE EERE EE EEE EEE EKER EEE LEE EEE EEE EEEKE RRKEE RH ERE RHEE RE 


EVEN (GREEN + FLASH) 11110000 
ODD (RED + BLUE) 10101010 


The first bit in the even byte is set, 
showing green, and the first bit in the 
odd byte is set, showing red. Green 
and red together give yellow. The sec- 
ond bit of the odd byte is also set, 
showing flashing. So the left pixel is yel- 
low flashing. Following across the pairs 
of adjacent bits in each byte we can 
a that this word will give a row of pix- 
els: 


YELLOW(FLASHING), 
YELLOW(FLASHING), RED, RED 


This all looks a bit daunting at first, 
but a bit of familiarity will soon make it 
seem fairly straightforward. Probably the 


best thing to do at this stage is to try 
poking some values in the screen 
ram, and try to work out why it pro- 
duced the effect it did. If you go back 
to the listings in part 5 of this series, 
you will find them quite useful for this 
exercise. 


ANDing 


Knowing how your QL converts ram 
data into pixels is all very well, but it is 
no use unless your program can 
determine whether individual bits 
have been set, and then take appro- 
priate action. There are several ways 
of doing this, but a couple of instruc- 
tions are probably all you need for 
most applications. 
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In part 5 of this series we covered the 
AND instruction. This carries out a bit by 
bit comparison of two numbers (which 
can be bytes, word or longword in size), 
and gives a 1 if and only if both bits are 
1. For example, if we AND. the binary 
numbers 10101010 and 10000000, we 
get 10000000, because the left bit of 
both numbers is set, and is the only one 
set. 

This gives us a mechanism for finding 
out if a particular bit of a number is set. 
We simply AND it with another number 
with only that bit already set. If the result 
has that bit set, we know the original 
number had that bit set set. Using this 
we can easily analyse each bit in turn. 

We are not restricted to analysing one 
bit at a time either. For instance, sup- 
pose we are working in moded4. If we 
AND a word in the screenramwith the 
word 10000001000000 we can find out 
if the first bit in both the even and odd 
bytes are set. If the result is all zeros we 
know that both bits are clear, and the 
left pixel of the word is black. If the result 
is not zero, further analysis will tell us if it 
is green, red or white. 

Although we could make do with this 
alone, to analyse a whole word in 
mode4 would require eight repetitions 
of almost identical code, with only the 
test word being changed. Our program 
could soon become very long! We 
could use the same code over again if 
we had an easy way of altering the test 
word to test for consecutive bits in turn 
automatically. To do this we can use 
one of a set of instructions called shifts 
and rotates. 


RORing 


| am only going to deal with one of 
these, the one which is useful in this 
particular problem. The instruction is 
ROR, which stands for “rotate bits to the 
right”. In this instruction, the bits of the 
number form a loop with the carry bit in 
the status register. When the instruction 
is carried out, all the bits in the number 
move one place to the right. The right 
hand bit goes into the carry bit of the 
status register, and the contents of the 
status register goes into the left hand bit 
of the number. Repetition of this instruc- 
tion will eventually bring the original 
number back into place, hence the term 
“rotate”. 

What makes the ROR instruction use- 
ful here is this. If we ROR the test word 
between each AND instruction, we can 
use the same AND instruction over 
again in a loop to test each bit in turn, 
instead of having long repetitive code 
with just one line slightly altered. 

In order to demonstrate these ideas, | 
have produced Listing one, a routine 
which will load a screen from a file, and 
then convert it from colour to mono- 
chrome in mode4. When | started exper- 
imenting with this routine, | intended to 


Listing < 


z=RESPR (512) 
LBYTES flpi_Listingl_code,z 
OPEN#3 ,con_512x256a0x0 
REFeat loop 

CLS#3 
PRINT#S3,"Process a screen file? (Y/N)" 


a=CODE ( INKEY# (#3,-1)) 
> SELect ON a 
O = 89,121:CALL z 
Oo = 78,110: STOP 

END SELect 

PAUSE -1 

END REPeat icop 


convert red and green into 
dark and light grey, leaving 
black and white the same. 
However, the stipple combina- 
tions for these tend to produce 
a stripey effect, which is not 
very good. In the end, | opted 
for converting red into a 
green/black chequered stipple, 
and white into a green/white 
chequered stipple, leaving 
black and green the same. 
This produces an acceptable 
black and green monchrome 
effect. After you have typed in 
the routine, it is easy to alter 
these to see if they get better. 
The listing is quite long, but 
most of it involves a recycling 
of ideas used previously, so will 
not require much explanation. 
We start by opening a con- 
sole channel to input the 
screen file name. The window 
occupies the entire screen, so 
that it can also be used to put 
new pixels on the screen. Next, 
we write a prompt in the win- 
dow asking for the name of the 
screen file. A line of characters 
is fetched from the keyboard 
and stored in a buffer. An 
attempt is then made to open 
a file, using this string as a file 
name (including drive). If this is 
unsuccessful for any reason, 
an error message is printed, 
and the prompt for a file name 
is repeated. If this is successful, 
the file is opened, and the con- 
tents loaded into the screen. 


The Procedure 


This has all been covered in 
previous parts of this series. 
The spaces required for para- 
meters, buffers, text and chan- 
nel IDs are towards the end of 
the listing. 

Having loaded our screen 
tile, we now convert it to mono- 
chrome, which is the main part 
of the program. It is probably 
best to read this part while fol- 
lowing the listing. 


First we move the start address 
of the screenram($20000) into 
register A1, and move $FF into 
register D5 as a row counter. 
Neither of these need resetting 
during the routine, so they are 
outside the main loop. The main 
loop, called ROWLOOP starts 
with moving $3F into register D6 
as a counter for the words in the 
row. This will need resetting each 
time we start to process a new 
row, which is why it is in that 
position. The first embedded 
loop, called WORDLOOP, starts 
by moving the contents of the word whose address 
is in Al, into register D1, ready for processing. This 
processing involves looping through the eight bits in 
the even and odd addresses of the word together, so 
we move 7 into register D2 to act as a bit counter. 

Next, we move the test word (the one we are going 
to AND with the data) into D3. As we are going to 
start by testing the far right bit in the two bytes, we 
move the binary number 1000000010000000, which 
is the same as the 
hex number $8080. 
Your assembler 


Listing 3 


lf the pixel was neither black 
nor white, it means that either 
the bit in the even or the odd 
address was set, but not both 
or neither. To find out which, 
we need to repeat the first two 
lines of BITLOOP to test the 
two bits again. The result of this 
test is compared with $SFF. 


Red and Green 


Now if the pixel is red, then 
the AND will result in a number 
less than $FF, and the compar- 
ison will result in a minus num- 
ber (remember, CMP. involves 
subtracting). In this case we 
branch to process a red pixel. 

If each of these does not 
result in a branch, the pixel 
must have been green (the 
only other possibility), so we 


may allow you to 100 REMark Sinclair QL World HEX LOADER v 3 


use binary notation | {55 


i10 REMark by Marcus Jeffery & Simon N Goodwin 


in the listing, in | 130 cls: RESTORE :READ space: start=RESPR (space) 
which case do So, | 140 PRINT “Loading Hex...":HEX LOAD start 


because it makes it 150 INPUT "Save to file... 
much clearer why | 436 
that 


"S#$ 
166 SBYTES £3,start,byte:STOP 


number iS | 180 DEFine FuNction DECIMAL (x) 


being used. 190 RETurn CODE (h$ (x) )-48-7% (nS (x) >"9") 


ae P 
We now come to oe END, DEFine DECIMAL 


the inner 
called BITLOOP, | 23° byte=0:checksum=0 

249 REPeat load_hex_digit 
Becauase the AND | 355 Reap hs 
instruction might | 260 


alter the test word, 270 IF LEN(h$) MOD 2 


280 PRINT "Odd number of hex digits in: 


we have to make | 594 Dats 


END IF 


loop, 220 DEFine PROCedure HEX_LOAD(start) 


IF hS="e": EXIT toad hex_digits 


“She 


another copy of it to | 300 


do the actual test- 
ing, SO we start the 
loop by moving the 
contents of register 
D3 into register D4, 
which will actually 
be used in the test- 
ing. 

We now AND the 
word in D1 (which 
contains the con- 
tents of our screen- 
ramaddress) with 
the test word in D4, 
leaving the result in 
D4. If the result is 
zero, the pixel is 
black, and we 
branch to an 
address to process 
a black pixel. 

If the pixel was 
white, the test word 
would be unaltered. 
We compare it with 
D3 to see if they are 
still the same, and if 
they are, we branch 
to process a white 
pixel. 


FOR b=1 TO LEN(h#) STEP 2 
hb=DECIMAL (b) : ib=DECIMAL (b+1) 
IF hb<O OR hb>iS OR 1b<O OR 1b>15 
PRINT "Illegal hex digit in: "“;h#:STOP 
END IF 
PORE start+byte, ié#hb+lb5 
checksum=checksum+1é6*hb+1b 
byte=bytetl 
END FOR b 
END REP@at load_hex_digits 
PRINT checksum:STOP 
READ check 
IF check< -checksum 
PRINT. "Checksum incorrect. Recheck data. 
END IF 
PRINT "Checksum correct. Data entered at: “sstart 
END DEFine HEX_LOAD 


"3 STOR, 


REMark Space requirements for the machine code 
DATA 


DATA "43FA0136": REMark LEA 
DATA "347800C6": REMark MOVEA. WwW 
DATA "4E92"3 REMark JSR 
DATA "43FA0138": REMark LEA 
DATA "2288": REMark MOVE.L 
DATA "43FA0132":REMark .PTEXT LEA 
DATA "2051": REMark MOVEA.L 
DATA "43FA013C":REMark LEA 
DATA "347800D0": REMar k MOVEA.W 
DATA "4E92";REMark JSR 
DATA "43FA0122": REMark LEA 
DATA "2051": REMark MOVEA.L 
DATA "43FA013C"s REMark LEA 
DATA "7002": REMark MOVEG 
DATA “343C0064"s REMark MOVE. W 
DATA "74FF":REMark , MOVE 
DATA "4643": REMark " TRAP 
DATA "5381":REMark SUBG.L 
DATA "“41FA012A":REMark LEA 


CON,A1 
$C4,A2 
(A2) 

ID,Al 

AO, (A1) 
ID,AL 

(AL) ,AO 
TEXT,Al 
$DO,A2 
(A2) 

ID,AL 

(A1) AG 
BUFFER, Al 
#$2,D0 
#BUFLEN ,D2 


BUFPOS ,AG 
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branch to process a green pixel. Whichever 
pixel colour we had, the routine will return us 
to address RET after the pixel has been 
processed. At this point we ROR the word 
containing the test bits. This means that next 
time we loop round, we shall be testing the 
next bits to the right, which will give us the 
next pixel to the right. So we are now ready 
to decrement the bit counter and branch 
back to the start of the BITLOOP with a 
DBRA instruction. 

After we have looped through all the bits, 
we leave BITLOOP, and move on to the next 
word. So we ADD 2 to register Ai to incre- 
ment the address to the next screen word. 
We can then decrement the word counter, 
and loop back to the start of WORDLOOP. 

After we have looped through all the 
words in the row, we leave WORDLOOP, 
and move on to the next row. 

Now processing the pixels involves draw- 
ing a1 by 1 block in each pixel position. 
When we start a new row, we have to set the 
coordinates (XKORIGIN and YORIGIN) to the 
start of the next row. This means increment- 
ing YORIGIN for a new row, and making 
XORIGIN zero for the left of the screen. This 
done, we can decrement the row counter, 
and loop back to the start of ROWLOOP. 


Tidying Up 


After we have looped through all the rows 
(processed the entire screen), we have some 
tidying up to to. First, if we are going to use 
the parameter block again to process anoth- 
er screen, we need to reset XORIGIN and 
YORIGIN to the top left corner of the screen. 
Finally, we have to close the channels, 
before returning to SuperBasic. 

Apart from the lines altering XORIGIN and 
YORIGIN (which are specific to this particular 
program), what we have covered so far is a 
method of analysing every pixel on the 
screen, and then branching to an appropri- 
ate routine according to what colour the 
pixel we find. What those routines will be will 
depend on what you intend to do with the 
information. As | mentioned before, the clas- 
sic situation is using the information to a 
printer screen dump routine, where appropri- 
ate codes are sent to the printer to make a 
printout of your screen. This requires a good 
understanding of your printer manual, and 
varies greatly from printer to printer. 

Other applications may include producing 
a compressed screen file, or simply count- 
ing how many pixels are a particular colour, 
or finding out exactly where a particular 
block of colour starts and ends. You could 
turn the picture upside down or back to 
front, or, with a bit more difficulty, put it on its 
side. To be completely silly, you could make 
each colour play a different sound, and turn 
your picture into music! 

But, as promised, we shall turn the picture 
into monochrome shades of green. 

Our routine to colour a block. on the 
screen will alter many registers. In order to 
deal with this we save all the register on the 
stack with a MOVEMLL instruction. So this is 
what the first line does whether we branch 


DATA 
DATA 
DATA 


730 
740 


DATA 
DATA 


DATA 


7460 
77Q 
780 
790 
800 
810 
820 
830 
840 
B50 
840 
870 
8380 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 
990 
1000 
1019 
1020 
1030 
1040 
1050 
1046 
1070 
1080 
19090 
1100 
11140 
1120 
1130 
11495 
1150 
11460 
11790 
1180 
1190 
1200 
i210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1220 
1340 


1350 
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DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
LATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 
DATA 


“3081":REMark 
"41F 80124": REMar k 
"7601": REMark 
“72FF":REMark 
"7001": REMark 
“AE42":REMark 
"4880": REMark 
"670A": REMark 
"347300CA" : REMark 
"4E92": REMark 
“4EFAFFBC": REMark 
“43FA00F8": REMark 
"2288":REMark 


"243000008000": REMark 
"227000020000": REMark 


"76FF": REMark 
"207A00E4": REMar k 
"7048": REMark 
"4E43":REMark 


"2276000020000": REMar k 


"“3ASCOOFF": REMark 
"3C3COOSF":REMark 
"3211"s REMark 
"7407": REMark 
"363C8080":REMark 
"3803": REMark 
"C841":REMark 
"67000062": REMar k 
"B843": REMark 
"6700007E": REMar k 
“3603":REMark 
"C841";REMark 
“OC4400FF": REMark 
"6B000066": REMark 
"60000056": REMark 
"E2Q5B": REMark 
"SICAFFDE":REMark 


.« ROWLOOP 
- WORDLGOP 


-BITLOOP 


~RET 


"D3FCOO000002" : REMar k 


"S1CEFFCC":REMark 
"47FAQ096": REMar k 
"06530001": REMark 
“47FAR008C"s REMark 
"36BC0000": REMark 
"Si CDFFB4": REMar k 
“47FA0080": REMark 
“36BC0000": REMark 
"“A7FAO007A": REMark 
"36BC0000": REMark 
“43F 80074": REMark 
"2051": REMark 
"7002": REMark 
"4E42": REMark 
“A3FAOOSE": REMark 
"2651": REMark 
"7002": REMark 
"4E42"5 REMark 
“4E75": REMark 
"“48E7FFFF":REMark 
"7200": REMark 
"60000022": REMark 
“A8E7FFFF": REMark 
"12300004": REMark 
"60000016": REMark 
“48E7FFFF":REMark 
"123COO0EO":REMark 
“SQ000008" : REMark 
“4S3E7F FFF": REMarik 
“123C00D4": REMark 
“43FA0028":REMark 
"2051": REMark 
"43FA0026"3REMark 
"702E":REMar k 
"“76FF": REMark 
“4E43":REMark 
“47F 80020" :REMark 
"S253": REMark 
“ACDFFFFF":REMark 
"SOO00FF70": REMark 
"9000": REMark 
"9007": REMark 
"O200": REMark 
"0100": REMark 
"90000": REMark 
"9000": REMar k 
“00000600":; REMark 
"9001": REMark 
“OO01": REMark 
"9000": REMark 
"0000": REMark 
"00000000" : REMark 
"“OOOC": REMark 


-ID 
- BLOCK 


- XORIGIN 
- YORIGIN 
«FILE 
- TEXT 


"46494045204E414D45203F20" 
REMark 


"0000": REMark 
"4" 29597 


MOVE.W 
LEA 
MOVEG 
MOVEQ 
MOVEG 
TRAP 
TST.L 
BE®.S 
MOVEA.W 
JSR 

JMP 

LEA 
MOVE.L 
MOVE.L 
MOVEA.L 
MOVER 
MOVEA.L 
MOVE® 
TRAP 
MOVEA.L 
MOVE .W 
MOVE .W 
MOVE.W 
MOVE 
MOVE. W 
MOVE .W 
AND. W 
BEG 
CMP. W 
BEO 
MOVE.W 
AND.W 
CMPI.W 


MOVEM.L 
MOVE® 
BRA 
MOVEM.L 
MOVE.B 
BRA 
MOVEM.L 


D1, (AO) 
BUFPOS , AO 
#1,03 
#-1,D1i 
#1,D0 

#2 

DO 
GOT_FILE 
$CA,AZ 
(A2) 

PTEXT 
FILE,Ai 
AO, (AL) 
##8000,D2 
#$20000, 41 


#$20000,Ai 
#5FF ,D5 
#S3F ,D& 
(A1) ,Di 
#7,D2 
#$9080, 03 
D3,D4 
Di,D4 


D2, BITLOOP 
#2,A1 

Dé, WORDLOGF 
YORIGIN,AS 
#1, (AZ) 


» XORIGIN, Az 


#0, (AS) 
DS, ROWLOGP 
XORIGIN, AS 
#0, (AS) 
YORIGIN, 4&3 
#0, (AZ) 
FILE,AL 
(A1) ,AO 
#2,D0 

#2 

ID,At 

(A1) AO 
#2,D0 

#2 


AO-A7/DO-D7 ,- (A?) 
#0,D1 

DRAW 
AO-A7/DO-B7,-tA7) 
#4,D1 

DRAW 
AQ-A7/DO-D7 ,— (AF) 
#$E0,D1i 

DRAW 
A0-A7/DO-D7 yi A7) 


“ #$D4,D1 


ID,At 

(AL) ,AO 

BLOCK ,A1 

#$2E,DO 

#=1.D3 

#3 

XORIGIN,AS 

#1, (AS) 
(A7)+,DO-D7/A0-47 


00000000 
$0001 
$0001 
$0000 
$0000 
$0000000U 
$000C 


“FILE NAME ? ™ 
$0000 


to BLACK, GREEN, RED or 
WHITE. It is not necessary 
to save all registers, but 
rather than work out which 
do and do not need saving, 
its simpler to save the lot. 

Colouring a block is a 
TRAP #3 routine. It first 
requires the colour of the 
block in register D1. BLACK 
moves zero into D1 for 
black, and GREEN moves 4 
into D1 for green. RED 
moves $224 into D1 to give 
a green/black chequered 
stiople, and WHITE moves 
$212 into D1 to give a 
green/white chequered stip- 
ple. The rest is the same 
whatever colour, so they all 
branch to common code, 
DRAW. The console chan- 
nel ID is required in AO, and 
the address of the block 
parameters is required in 
A1. $2E is required in DO to 
tell QDOS that the TRAP #3 
routine is going to colour a 
block of screen. We put -1 
in D3 to tell QDOS to keep 
going until it has finished 
the routine (infinite timeout). 
The trap call will then carry 
out the routine. 

After returning from the 


routine, we need to incre- 
ment XORIGIN ready for the 
next pixel to the right. Finally 
we use a MOVEMLL instruc- 
tion to restore the registers 
from the stack, before 
branching back to RET to 
process the next pixel. 

The whole listing ends 
with the parameters, etc. 
The only part that needs 
any mention is the block 
definition, four words. The 
first two are the width and 
height of the block. Since 
we are drawing a pixel 
sized block, these are both 
1. The other two are the X 
and Y origins, and these are 
set at zero for the top left 
corner of the screen. These 
need their own labels, 
because they are continual- 
ly altered as pixels are 
drawn over the entire 
screen. 


Mods to Try 


| have mentioned one or 
two things you can try to 
modify the listing once you 
have got it working. 
Unfortunately, they are 


mostly concerned with what 
you might do with the infor- 
mation the routine gathers 
about pixel colours. None of 
them have much to do with 
the heart of the routine, 
which is looping through 
the screen pixels to see 
what colour they actually 
are. There are other ways of 
doing this, but you are not 
likely to discover them from 
what has been said so far. 
One that is worth trying is 
this. The rotate instructions 
pushes the bit that falls off 
the end into the carry bit of 
the status register. So we 
could move the word from 
from screenraminto a data 
register and then “rotate bits 
to the left” with a ROL 
instruction. This would 
cause the right most bit to 
go into the carry bit which 
could then be tested for a 1 
with a “branch on carry set” 
or BCS instruction, or tested 
for a zero with a “branch on 
carry clear’ or BCC.This 
method might have the 
advantage in only requiring 
a ROL while the original list- 
ing requires a ROR followed 
by an AND to do the same 


job of isolating a bit for 
analysis. But it has the dis- 
advantage of only testing 
one bit at a time, while ROR 
plus AND can test two, or 
any number of bits up to 32 
at once. We used it to test 
two bits at a time, one in 
the even and one in the 
odd byte. Since the colour 
depends on two bits, the 
extra code needed might 
outweigh any advantage. 
Anyway, if you feel confi- 
dent, you might like to give 
it a try. 

As in part 7, | have loaded 
data into registers for vec- 
tored subroutines and trap 
calls without checking to 
see if the required data is 
already there. You will 
almost certainly be able to 
reduce the length slightly if 
you look for redundant lines 
of code and remove them. 

Listing Two is a short 
SuperBasic program to load 
and run the code. 

Once again, Listing 
Three is Marcus and 
Simon's Hex Loader for 
those who do not have an 
assembler. 

Happy coding! 


Tecmo crssaseess §=§ (FEO)  W/A Richardson & Co. 
(SINCLAIR OL PRICE LIST Site cio ue 
DEC ‘93 All Prices Include 17.5% VAT 


[ ASK FOR DETAILS OF ECONOMY RANGE OF F.D.D. UP 
TO aMk ANT) HDD. UP TO 44MB. 


QL Computer, PSU, T.V. Lead, PSION V245 Software (Word Processor, Spromishect, 
Business Graphics). Handbook for QL, Programs , & Supectusic. 


J$ COMPLETE 
Database & 

CESS EEE) Pree ono years membership to QUANTA. the 
free library programs, Newsletters & HELP. 6 


| Fxpacesedie essories J 


3S oan INTEREACS, ae FITTING, with lead to 102 KEY KEYBOARD £75.00 
KEYB version, lt 
PC KEYBOARD INTERPACS and kevBOARD —+ REDUCED PRICES SREB 5 55.00 5500" 
CASE and LEAD for EXTERNAL FITTING of Keyboard Interface for simpler assembly 2 Bote 
JOYSTICK with Qk lead (no interface required) £ 10.00 
* QL MOUSE, 3 Button, Software controlled, externally mounted, simply fits in SER2 £45.00 
TANDATA MODEMS AGAIN IN STOCK 


PART EXCHANGE £30 OFF ABOVE, Send in old QL (Unit only, any condition) - 
QL & PSU only. JS £80 IME63 (Par exchango allowance £15 if required) 


* NOTE: EXTERNAL (SER) 3 BUTTON MOUSE AND SOFTWARE * 
WITH EXTRA FUN IS. NOW HERMES COMPATIBLE, 


1Mb, 2Mb and 4Mb{ 


ECONOMY MULTI-COMPUTER FLOPPY DISK DRIVE 


JS £120 


400 
JMROM £100.00 


sedepatent GE QL User & eee uP with over 
WITH 


JS ROM_£90 JM_= 70.00 


TELEPHONE RE: UPDATING EXISTING DRIVES. ALSO DETAILS OF HARD DISK DRIVES. 
PHILIPS 14” HIGH RES COLOUR EGA .31 DOT PITCH, FULL 85 COL ‘ | { ! 


[Monitors 


ras 


Microdrive Cartridges and Spares 


4 New Carmidges in a wallet. © 10.00 8 prog cans for reformatting in 2 wallets £ 15.00 
Plastic Storage filing box including 20 new cartridges £45.00 
QL Psion Software V2.35 Includes Quill, Abacus, Archive, and Easel IN WALLET £ 18.00 
QL Psion Software Separate programs £ 10.00 
QL power Supply Unit ©1000 QL Primer YF £27 Membrane (and instructions) € 9.00 
TV or Network leads “ QL Top & Bottom Case £ 5.00 
ICs ZX 8301 £ 9.00 zx 3302 £ 3.00 8049 (PC) £ 3.00 MC 1377 £ 3.00 
QL SERVICE MANUAL & CIRCUITS £25.00 y 
REE) payment terms: F 
aa Cheques - allow 10 days Pate es — 
¢ 25) Product subject to availabiliny, ZOE MOBILE: 0850 597650 
TEL: 0753 888866 Fax: 0753 887149 


ECONOMY DRIVE PRICES INCLUDING VAT @ 172% 
caraciry: y [27 | Se JL axe |e | oes 
SINGLE DRIVE[ £69 |[_285__|[_ £120 |[ ——] 
TWIN DRIVES [£99 |[ 2150 |[ e199 |[ 2135 |[ 2175 


WITH AMBER OR GREEN TEXT FEATURE, IDEAL FOR WORD 
PROCESSING, RECONDITIONED, 90 DAY WARRANTY. 

OK FOR PC AND QL SELF SENSING AND MANY EXT/L CONTROLS. 
“MONO OPTION” WITH 


2" GREEN SCREEN. 


TF SERVICES 


MINERVA 


The ULTIMATE operating system upgrade 


MINERVA RTC (MKII) - battery for 256 bytes rari) 
CRASHPROOF clock & Philips (2C bus tor interfacing | 
Can autobsot from battery backed ram. Quick start-up. 


Other features common to MK I/RTC(MKII) 


DEBUGGED operating systeny autoboot on reset/ 
Multiple Basic/ faster scheduler-graphics (10% of 
lighting)-string handling) WHEN ERROR/2nd screen/ 
TRACE) foreign keyboard drivers) ‘warm’ fast resey/ 
Auto reboot after power failure. V1.97 now with built in 
Multibasic and split OUTPUT baud rates with Hermes. 


Ist upgrade: free. Otherwise £3 (+ £5 for manual if 
requd) — Send sac, Minerva & NEW disk/3 mdvs 
MK1 to MKII upgrade - £30 


CMKI.... £40 MKII(RTC)... £65 ) 
GOLD CARD (v2.24+) COMPATIBLE 


QL SPARES 


Faulty QL board (no plug-in chips). 
Keyboard membranc .... Circuit diagrams .. 
68008 cpu... 1377 PAL... 

JM ROM. Power supp! 
8302 ULA 8301 ULA.. 
8049 IPC MDV ULA 


“£10 
“12 


Other components/(sockets etc) please phone 


QL REPAIRS 


Fixed price for unmodified QLs, excl microdrives. 
QLs tested with Thom-EMI rig and ROM software 


£27 including 6 month guarantce 


Prices include post & packing (UK only). Payment by Mastercard/Visa/Acccss/Eurocard/cheque/postal order/PO 
Giro transfer (58 267 3909). MAIL ORDER ONLY - no callcrs without ringing first. Ring for overscas prices. 


Holly Corner, Priory Road, ASCOT, Berks 


Tel: 0344-890986 


Fax & BBS: 0344-890987 


A replacement QL co-processor for 
the QLs awful IPC 8049 _) 


- Do you get keyboard bounce? 
- Do you find fast serial input unreliable? 
- Do you want to connect a moaem at 19200bps 


If you can say onc YES , then you nced HERMES 


~ 19200bps RELIABLE serial input - NO QCONNECT. 

~ Independent input baud rates - use serial mouse & print 
Stops keyboard bounce (unwanted repeat chrs) 

+ Improves “fuzzy” and ‘random’ sound 

+ Provides extra input/output lines. 

~ Key click 


Firing is simple. Remove the OL top (8 screws) & 
replace the chip marked 8049 or $749 next wo nidv | 


£25 including manual/sottware 


I°C Interfaces 


The PC bus was designed by Philips to simplify 
interfacing. Minerva MKII clock is driven by an [?C 
chip, & a connector allows connection of other circuits. 
Our external circuits will interconnect without leads. | 
Up to 5 interfaces can be powered off the QL. 


Parallel Interface gives 
Can be used for 
eg model train controlicrs. Can input direct to 


motor drivers (eg L293/L298). 


16 inpuyjoutput lines. 
logic level output 


Analogue Interface Each gives 8 analogue to 

digital inputs, and 2 digital/analogue outputs. For 

temp measurement, sound sampling etc. 

Data sheets. (analogue/parallel 1?C chips). 

Control software/manual (Supérbasic exms)......£2 
(First interface purchase includes free 1SD/9D lead) 


QBBS - UKs first QL scrolling Bulletin Board 
Note the new telephone number below 

TANDATA callers add SIX zeros (000000) or wait 

for 3 seconds of modem tone. if dialling manually. 


Sinclair QL World Vol. 3 Issue. 1 Z 9 


Now available on a QL near you... 


GT-Prolog/QL 


Interactive Workbench (needs 512k) 
* Windows, Menus, Dialogues 
* Editor 
* Debugger 
User Guide, Reference Manual 
Full QDOS compatibility 
Configurable Memory up to 16Mb 


Edinburgh Syntax 

Incremental Compiler 

Automatic Garbage Collectors 
Tail-Recursion Optimisation 
First Argument Indexing/Hashing 
32bit integers / 48bit reals 

255 byte atoms / 32kb strings 


Turbo Performance - Naive Reverse exceeds 5k LIPS (GC) 
Price including postage/packing £89.95 


For more information contact us at 
Rosebank, Stream Road, 
Upton, Oxon, OX11 9JG 
Tel/Fax: 0235-851818 


Grange 


Technology 
Limited 


ie eee 


AUSTRIA - DER Comput 
Club. Contact: Peter Postl, 
Stiegerg 5, 1150 Wien, Austra. 


BELGIUM - Club Sinclair 
BruQsl. Contact: Jaques 
Tasset, Aarlenstraat 104, 1040 
Brussels, Belgium. 


QL Club. Contact: Leon 
Thianche, Rue Paul Wemaere 
12-14, 1150 Bruxelles, Belgium. 


FRANCE - QL Contact 
France. Contact: Jean-Louis 
Dianoux, 22 Avenue Lenine, 
93230 Romainville, France. 


GERMANY - Sinclair QL 
User Club eV. Contact: Franz 
Herrmann, Talstrasse 21, d- 
W5460 Ochenfels, West 
Germany. Magazine: Quasar. 


GREECE - QL Athens Club. 
Contact: Stathis Grigoriadis, 
Tarsu 6-8, 10440 Athens, 
Greece. 


HOLLAND - Sin_QL_Air. 
Contact: Secretary: Marco 
Holmer, J P Coenstraat, 3531 
EN Utrecht, Netherlands. 
Magazine: Quasar. Editor: 
Same as Secretary. (Chairman: 
Cor Biemans, Elzenstraat 5, 
5461 CL Vehgel, Netherlands. 


ITALY - Qitaly Club. Contact: 
Roberto Orlandi, Via Brescia 26, 
25039 Traveglianto (BS), Italy, 
Tel. +39 30 6863311. Magazine: 
Qitaly Magazine. Editor: Dr Eros 
Forenzi, Via Valeriana 44, 23010 
Berbenno (SO), Italy. Tel, +39 
342 590450, 


NORWAY - Norwegian All 
Sinclair Association (NASA). 
Contact: P Monstad, NASA, N- 
5580 Oelen, Norway. Magazine: 
Sinclair Magazine. 


SCOTLAND - Scottish QL 
Users Group. Contact: Alan 
Pemberton, 65 Lingerwood 
Road, Newtongrange, Mid- 


lothian EH22 4QQ. Newsletter. 
SPAIN - Qliper. Editor, Mar- 
cos Cruz, Acacias 44, (Mon- 
teclaro), E-28223, Pozuelo de 
Alarcon, Spain. Mag: Qliper. 


SWEDEN - Svenska QL- 
Gruppen. Contact: Johan 
Boman, Toftaasgatan 73, 
42147 Vastra Frolunda, 
Sweden. Magazine: QL-Bladet 


Jamten-TCL (Intemational 
QL echomail conferences) 
BBS +46-63-133330. Michael 
Cronsten, Radhusgatan 61E, 
83137 Ostersund, Sweden. 


TURKEY - QL Qlub. Contact: 
Bulent Artuz, Prof Sitesi B/1 D/5, 
Etiler 80600, Istanbul, Turkey. 


UK - Quanta (UK): Mem- 
bership Secretary, Bill. Newell, 
213 Manor Road, Benfleet, 
Essex SS7 4JD. Magazine: 
Quanta. Editor; Bill Fuggle, 20 
Widnes Avenue, Selly Oak, 
Birmingham B29 6QE. Quanta. 

Ashstead sub-group: Derek 
Stewart, 13 Beales Road, Great 
Bookham, Surrey KT23 4NA 

Bristol sub-group: Roy 
Brereton, 94 Teignmouth Road, 
Clevedon, Avon BS21 6DR. 

East Anglia: Geraint Jones, 1 


Bridgate Court, Thetford |P24 
3AJ. (Also market Rom 
Switcher) 

Essex sub-group: Dave 
Walker, 22 Kempton’s Mead, 
Potters Bar, Herts EM6 3HZ. 

London sub-group: Jeremy 
Davis, 6 Elmcroft Crescent, 
Harrow, Middx HA2 6HN. 

North-east: Derek Stewart, 20 
Emily Street, Gateshead. 

Northern Ireland: Billy 
Turkington, Fairyhill, Rostrevor, 
Newry, Co. Down, BT34 3BB, 

Mid-Southern sub-group: 
Geoff Fish, 44 Billing Avenue, 
Wokingham, Berks RG11 4JE. 

QL User Group (West 
Midlands): Mike Bedford-White, 
16 Westfield Road, Acocks 
Green, Bimingham B27 7TL 

QL MUG (Merseyside): G 
Reynolds 051 932 1484, 
evenings. Meet fortnightly. 

Solent sub-group: Graham 
Evans, 32 Reeves Way, 
Lowford, Bursledon, South- 
ampton. Tel. 0703 403350. 


USA - New England Sinclair 
QL User Group. Contact Sherm 
Waterman, POBox 8763, Boston 
MA 02114, USA. Mag: NES- 
QLUG News. Editor: Peter Hale, 
195 Central Ave, Chelsea, MA 
02150, USA 


UK 
£FA3.40 
(12 MONTHS) 


EUROPE 
£32.90 
(I2MONTHS) 


REST OF 
WORLD 
£40.90 
(12 MONTHS) 


PLEASE SEND YOUR 
SUBSCRIPTION FORM TO 
SINCLAIR QL WORLD, 
THE BLUE BARN, TEW 
LANE, WOOTTON, 
WOODSTOCK, OXON. 
OX71HA. 

TEL:0993 811181 

FAX:0993 811481 


SUBSCRIBE TO 
SINCLAIR OL WORLD 
AT LAST YEARS 
PRICES AND SAVE 


| WISH TO SUBSCRIBE TO 
SINCLAIR QL WORLD 

WE HAVE HAD TO RAISE THE 
COVER PRICE OF QLWORLD 
BUT WILL BE HOLDING LAST 
YEARS SUBSCRIPTION PRICE 
FOR THE IMMEDIATE FUTURE 
ONLY. 


Existing subscribers will not be affected. 


Coeoeeeeeeeeeoeeeeeeeeeseeeeerd 
PLEASE DEBIT MY CREDIT CARD ACCESS/VISA 

ROP) TNUTIB EIR c occsrsionsy innrtounstignbisoast agi eqns ten ont ine Ul Aaa eamectan ema ram Na 
EXPIRY DATE 

PLEASE SEND ME A 12 MONTH SUBSCRIPTION TO SINCLAIR 

QL WORLD, 


PEPER PEEP PEERED ECP E PEEP PERE PEEPS POUR PEEPS TEEPE PREP PPE PETER 


cpEbts Felco) PSE DALI SE eecaciennarinomimnmamnanmemninny cia uNRRTORTTIRNRITE NET T INI 
eis eh TA Mee Gols nd ttaiein tnd waitr taiga tages enad tnd axe pnie ears veuatine 


Dilwyn Jones Computing 


41 BRO EMRYS, TAL-Y-BONT, BANGOR, 
GWYNEDD, LL57 3YT, GREAT BRITAIN 
FAX/TEL: (0248) 354023 


DATABASE SOFTWARE GENEALOGY 


COCKTAILS WAITERE10 00 
DATA DESIGN 3... 
DATA DESIGN API... 


SUPER DISK INDEXER ... 


DTP & CLIPART 

PAGE DESIGNER 3. 
Available at last! 

UPGRADE FROM PD2? ..... 
SCANNED CLIPART I (U) ... 


DISCOVER ss 
MULTI-DISCOVER . 


QUESTION MASTER ©. 

QUIZ MASTER 2 (U)..... 

RETURN TO EDEN . 

SOLITUDE (U) .sesvsvssve 

SQUIDGY ROUND THE WORLD (8) 


LABELLING 
ADDRESS BOOK&LABEL PRINTER .. 


SUPER DISK LABELLER evsssssssessovesssee 


GENEALOGIST 3 
new pointer driven version 
Upgrade 2nd Edition 


upgrade other versions, ask 
GENEALOGIST 2ND EDITION 


BUDGET 128K GENEALOGIST UU... 


QUICK MANDELBROT 3 (U) .. 
SCREEN COMPRESSION Jv. 
SCREEN SNATCHER (U)...... 
SIMPLE VIDEO TITLES 
TRANS24 (U) sovesossrssvosorenesenrsnsen 


HARDWARE 
MICRO PROCESS CONTROLLER 


QPOWER REGULATOR sess 
(unsuitable Gold Card) 


VOICE ANALYSER-New! 

Ask for details and price 

Add £2 50 postage for MPC, 
SERMOUSE AND VOICE ANALYSER 


QL TECHNICAL REVIEW 

issues 1-8 available 

QL ADVENTURER'S FORUM evsvesssssssssssssseresseseeeses £1.75 
Issues 1-9 available 

QL LEISURE REVIEW 

issues 1-2 available 

(UK prices only shown) 


PROGRAMMING 
BASIC REPORTER (U) ssssews: 


EASYPTR 3 PART 1. 
EASYPTR 3 PART 2... 
EASYPTR 3 PART 3 ..... 


MEGATOOLKIT EPROM (U) .. 
QLIBERATOR 3 36 ...... 
BUDGET QLIBERATOR (U) 


S EDIT EDITOR Ecbmamiicca et  O 00 


SCREEN DUMPS 
SIDEWINDER PLUS 


3 5” DSDD DISKS each 

3 5” DSHD DISKS each 1... , 

3 5” DISK LABELS (roll 100) .sssessssssrsssesvssessnersensond oe00 
3 5” LABELS (printer roll) sscso: Yh 
ADDRESS LABELS (roll 100) ovesssvoosseoncvsssrooveenseoen £2.00 
MICRODRIVE CARTRIDGES 

MDV LABELS (roll 100) sss. 

MOUSE MAT. onceesssesessssestssccesrsessessseensssees hae 

3 5” DISK DIVIDERS (20) csvevesssssssssesorsnsssesesssesssesenees: £3.00 
Add £0 50 postage for labels or mouse 

mat if only ordering those, or £2 50 postage 

for disks or disk box divider sets 


QUICK POSTERS (U..... 

ROB ROY PACK (U) 

SPELLBOUND 110000 a 
SPELLBOUND S E aro gSaoneasnsdiotnsseesbopeet 
TEXTIDY oss csesessesssscnessses ce Stopamacrerntteeneeded So OO, 
TEXT ‘N’ GRAPHIX sat ranrtesisetvoss eerste LOO. 


THE Pointer Environment package! 
QTOP .... 


SCREEN ECONOMISER (UW) 

SLOWGOLD (U).... sialic 

SPEEDSCREEN O Ee asseuerresesersp 

SPEEDSCREEN EPROM (U) . 
TASKMASTER sssclssooo:sscrsesieonereurissesnacornesctessesosstel "£25, 00 
VISION MIXER I. .sssssseosssoe sessnscinieerneed 10,00. 
VISION MIXER PLUS cerrasenresecne 0050) 


CALL OR WRITE FOR A FREE COPY OF 
OUR QL SOFTWARE CATALOGUE 
DETAILING AROUND 100 QL PRODUCTS 


PLEASE NOTE: (U) ABOVE MEANS THAT 
THE SOFTWARE IS SUITABLE FOR USE 
ON A 128K QL 


TERMS: POSTAGE-software sent post free to UK, overseas add £1 00 per program (maximum £3 00) Floppy disks, SERmouse, etc add £2 50 postage (see 
above) PAYMENT - IN UK currency (pounds sterling) only, please Valid methods of payment are cheque drawn on UK branch of bank or building 
society, Eurocheque, Postal Order, cash (send by registered pos) or by credit card - Visa, Access, Mastercard and Eurocard accepted Please make cheques 
etc payable to DILWYN JONES COMPUTING Minimum order value.£5 00 (due to bank charges) Goods remain property of Dilwyn Jones Computing 
until paid for in full Orders normally sent out within a few days of receipt, we will attempt to advise if any delay anticipated due to stock problems Orders 
can be accepted by telephone if paid for with credit card Orders paid with credit card can only be sent to cardholder's address under card company rules 


FAX - We now have a Fax machine on our usual number (0248) 354023 


